Click or drag to resize
TreeProvider Class
Provides methods for management of the tree structure.
Inheritance Hierarchy
SystemObject
  CMS.DocumentEngineTreeProvider

Namespace: CMS.DocumentEngine
Assembly: CMS.DocumentEngine (in CMS.DocumentEngine.dll) Version: 8.2.23
Syntax
C#
public class TreeProvider

The TreeProvider type exposes the following members.

Constructors
Methods
  NameDescription
Public methodStatic memberAddRating
Updates rating value of given document.
Public methodStatic memberAllSites
Returns true if the given site name value represents all sites
Public methodAttachmentSearch
Searches attachment binary data for search expression.
Public methodStatic memberClearCheckoutInformation
Clears the checkout information from the given tree node.
Public methodStatic memberClearWorkflowInformation
Clears the workflow information from the given tree node.
Public methodCopyNode(CopyDocumentSettings)
Copies node according to given parameters.
Public methodCopyNode(TreeNode, TreeNode, Boolean)
Copies the node to the specified location, optionally with permissions and child nodes. The copy is named according to the parameter and assigned to given owner and group.
Public methodCopyNode(TreeNode, Int32, Boolean, Int32, Int32, Boolean, String) Obsolete.
Copies the node to the specified location, optionally with permissions and child nodes. The copy is named according to the parameter and assigned to given owner and group.
Public methodCreateSiteRoot
Creates site tree root. For purposes of site creation.
Public methodDeleteLinks
Deletes document links to the specified node.
Public methodDeleteSiteTree
Deletes site tree root. For purposes of site deletion.
Public methodStatic memberEnsureRequiredColumns
Ensures columns required for selection in given column list. Returns the adjusted list
Protected methodExecuteQuery(String, QueryDataParameters)
Runs specified query with provided parameters.
Protected methodExecuteQuery(String, QueryDataParameters, String, String)
Runs specified query with provided parameters.
Protected methodExecuteQuery(String, QueryDataParameters, String, String, Int32, String)
Executes query and returns result as a dataset.
Public methodExecuteQuery(String, QueryDataParameters, String, String, Int32, String, Int32, Int32, Int32)
Executes query and returns result as a dataset.
Public methodStatic memberFilterOutDuplicateDocuments
Filters out duplicate documents (linked ones).
Public methodStatic memberFilterOutLocalizedRows
Removes nodes of any culture that are translated to required language.
Public methodStatic memberFilterOutLocalizedVersions(DataSet, String, String)
Removes nodes of default culture that are translated to required language.
Public methodStatic memberFilterOutLocalizedVersions(DataSet, String, String, String)
Removes nodes of default culture that are translated to required language.
Public methodStatic memberGetClassNamesWhereCondition
Returns where condition for given class names.
Public methodGetCombineWithDefaultCulture
Returns whether nodes should be combined with appropriate nodes of default culture if not localized. This applies only when using multilingual support. The default value is false.
Public methodStatic memberGetCompleteWhereCondition
Returns the complete where condition based on the given parameters.
Public methodStatic memberGetCultureWhereCondition
Returns where condition for given culture.
Public methodGetDefaultCultureCode
Returns default culture code specified in the CMSDefaultCultureCode configuration key.
Public methodStatic memberGetDependencyCacheKeys
Returns the cache dependencies keys array for the node - cache item keys affected when the node is changed.
Public methodStatic memberGetDocument(IDataContainer, TreeProvider)
Creates document from given data.
Public methodStatic memberGetDocumentNodeType(IDataContainer, TreeProvider)
Creates document from given data.
Public methodStatic memberGetDocumentCacheDependencies
Returns cache dependencies key for the specified document data source.
Protected methodGetEmptyDataSet
Returns an empty data set to be filled by the data.
Public methodStatic memberGetNodesOnPathWhereCondition
Returns where condition for all nodes on the path to the given alias path.
Public methodGetOriginalNode
Returns the original node for given link node in specified culture.
Public methodStatic memberGetRelationshipWhereCondition
Returns where condition for the given relationship or null if the relationship was not found.
Public methodGetUniqueDocumentName
Returns unique document name for the specified parent node. Does not check for duplicity if duplicity occurs within the currentNodeId.
Public methodGetUniqueNodeAlias
Returns unique node alias for the specified parent node. Does not check for duplicity if duplicity occurs within the currentNodeId.
Public methodGetUniqueNodeName
Returns unique node name for the specified parent node. Does not check for duplicity if duplicity occurs within the currentNodeId.
Public methodGetUniqueUrlPath
Returns unique URL path for the specified parent node. Does not check for duplicity if duplicity occurs within the currentNodeId.
Public methodGetUseParentNodeGroupID
Returns whether NodeGroupID property should be set according to the parent value.
Public methodStatic memberHasRated
Sets a flag indicating that user rated the document.
Public methodChangeCommunityGroup
Sets owner group of specified nodes
Public methodChangeCulture
Changes culture of the documents in old culture to the new one. If there is an existing document in new culture, the old culture version is not changed to the new one.
Public methodChangeSiteDefaultCulture(String, String)
Changes default culture of the site.
Public methodChangeSiteDefaultCulture(String, String, String)
Changes default culture of the site. Removes old culture from the site and adds the new one. Changes culture of the documents in the old culture to the new one. Doesn't handle collisions of existing documents in new culture.
Public methodCheckDocumentUIPermissions
Returns whether document permissions should be checked in the content management UI.
Public methodInitNodeOrders
Initializes the node order under specified parent node.
Public methodMoveNode(TreeNode, TreeNode, Boolean)
Moves the node to the specified location.
Public methodMoveNode(TreeNode, Int32, Boolean) Obsolete.
Moves the node to the specified location.
Public methodMoveNodeDown(Int32)
Moves specified node down in the order sequence (down = larger NodeOrder = further in the navigation).
Public methodMoveNodeDown(TreeNode)
Moves specified node down in the order sequence (down = larger NodeOrder = further in the navigation).
Public methodMoveNodeUp(Int32)
Moves specified node up in the order sequence (up = smaller NodeOrder = closer to beginning in the navigation).
Public methodMoveNodeUp(TreeNode)
Moves specified node up in the order sequence (up = smaller NodeOrder = closer to beginning in the navigation).
Public methodStatic memberRememberRating
Remember that user has rated the document.
Protected methodRemoveCMSExcludeDocumentsFromSearch
Filters results with AliasPath in CMSExcludeDocumentsFromSearch key.
Public methodStatic memberResetRating
Resets rating values of given document.
Public methodSearch(String, String, String, String, SearchModeEnum)
Searches specified node and all child nodes and returns results as a dataset with CMS_TREE data.
Public methodSearch(String, String, String, String, SearchModeEnum, Boolean)
Searches specified node and (optionally) all child nodes and returns results as a dataset with CMS_TREE data.
Public methodSearch(String, String, String, String, SearchModeEnum, Boolean, String)
Searches specified node and (optionally) all child nodes and returns results as a dataset with CMS_TREE data.
Public methodSearch(String, String, String, String, SearchModeEnum, Boolean, String, Boolean)
Searches specified node and returns results.
Public methodSearch(String, String, String, String, SearchModeEnum, Boolean, String, Boolean, Boolean, String, String)
Searches data and returns results.
Public methodSearch(String, String, String, String, SearchModeEnum, Boolean, String, Boolean, Boolean, String, String, Boolean)
Searches specified node and returns results.
Public methodSelectNodes
Gets the query for all published documents
Public methodSelectNodes(String)
Gets the query for all published documents of specific type
Public methodSelectNodes(NodeSelectionParameters)
Returns nodes matching the provided parameters. Result contains coupled data only if classNames are specified.
Public methodSelectNodes(Int32, String, String)
Returns nodes specified by node ID, culture and site name. Multiple nodes are returned if ALL_CULTURES passed in cultureCode parameter. Does not select coupled data.
Public methodSelectNodes(String, String, String, Boolean, String, String, String, Int32, Boolean, Int32, String)
Returns nodes specified by node alias path, culture and site name, optionally combined with default culture. Result contains coupled data only if classNames are specified.
Public methodSelectNodes(String, String, String, Boolean, String, String, String, Int32, Boolean, Guid, String, Boolean)
Returns nodes without coupled data specified by node alias path, culture and site name, optionally combined with default culture.
Public methodSelectNodes(String, String, String, Boolean, String, String, String, Int32, Boolean, Guid, String, Boolean, Int32, String)
Returns nodes without coupled data specified by node alias path, culture and site name, optionally combined with default culture.
Public methodSelectNodesCount
Returns nodes count matching the provided parameters.
Public methodSelectSingleDocument(Int32, Boolean, String)
Returns single node specified by document ID. If the result is a link to another document original document is returned instead.
Protected methodSelectSingleDocumentNodeType(Int32, Boolean, String)
Returns single node specified by document ID. If the result is a link to another document original document is returned instead.
Public methodSelectSingleNode(NodeSelectionParameters)
Returns single node matching the provided parameters.
Public methodSelectSingleNode(Int32, String)
Returns single node specified by node ID and culture.
Public methodSelectSingleNode(Guid, String, String)
Returns single node specified by node GUID, culture and site name. Does not include the coupled data.
Public methodSelectSingleNode(Int32, String, String)
Returns single node specified by specified node ID, culture and class name. Most efficient way of getting the document. Result contains coupled data only if classNames are specified.
Public methodSelectSingleNode(String, String, String)
Returns single node specified by alias path, culture and site name.
Public methodSelectSingleNode(Guid, String, String, Boolean)
Returns single node specified by node GUID, culture and site name. Does not include the coupled data.
Public methodSelectSingleNode(Int32, String, Boolean, Boolean)
Returns single node specified by node ID and culture, optionally combined with default culture.
Public methodSelectSingleNode(String, String, String, Boolean, String, Boolean, Boolean, Boolean)
Returns single node specified by alias path, culture and site name matching the provided parameters.
Public methodSelectSingleNode(String, String, String, Boolean, String, String, String, Int32, Boolean, String)
Returns single node specified by alias path, culture and site name matching the provided parameters. Result contains coupled data only if classNames are specified.
Protected methodSelectSingleNodeNodeType(NodeSelectionParameters)
Returns single node matching the provided parameters. Result contains coupled data only if classNames are specified.
Protected methodSelectSingleNodeNodeType(Guid, String, String, Boolean)
Returns single node specified by node GUID, culture and site name. Does not include the coupled data.
Protected methodSelectSingleNodeNodeType(Int32, String, Boolean, Boolean)
Returns single node specified by node ID and culture.
Protected methodSelectSingleNodeNodeType(String, String, String, Boolean, String, Boolean, Boolean, Boolean)
Returns single node specified by alias path, culture and site name.
Protected methodSelectSingleNodeNodeType(String, String, String, Boolean, String, String, String, Int32, Boolean, String)
Returns single node specified by alias path, culture and site name matching the provided parameters. Result contains coupled data only if classNames are specified.
Public methodSetNodeOrder(Int32, DocumentOrderEnum)
Sets the specified node order.
Public methodSetNodeOrder(Int32, Int32)
Sets the specified node order.
Public methodSetNodeOrder(TreeNode, DocumentOrderEnum)
Sets the specified node order.
Public methodSetNodeOrder(TreeNode, Int32)
Sets the specified node order.
Public methodStatic memberSetRating
Sets document new ratings.
Public methodSortNodesAlphabetically
Sort child nodes alphabetically.
Public methodSortNodesByDate
Sort child nodes by date.
Top
Extension Methods
  NameDescription
Public Extension MethodAsValue
Converts object to a query value which can be used as a query parameter
(Defined by QueryExtensions.)
Public Extension MethodGetAPIString
Gets the string by the specified resource key
(Defined by CoreExtensions.)
Public Extension MethodGetString
Gets the string by the specified resource key
(Defined by CoreExtensions.)
Public Extension MethodToBoolean
Returns the boolean representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToDateTime
Returns the DateTime representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToDouble
Returns the double representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToGuid
Returns the Guid representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToInteger
Returns the integer representation of an object or default value if not.
(Defined by CoreExtensions.)
Public Extension MethodToString
Returns the string representation of an object or default value if not.
(Defined by CoreExtensions.)
Top
Fields
  NameDescription
Public fieldStatic memberALL_CLASSNAMES
Supplementary constant to specify all class names.
Public fieldStatic memberALL_CULTURES
Supplementary constant to specify all document cultures.
Public fieldStatic memberALL_DOCUMENTS
Supplementary constant to specify all documents.
Public fieldStatic memberALL_LEVELS
All relative levels.
Public fieldStatic memberALL_SITES
Supplementary constant to specify all sites.
Public fieldStatic memberDEFAULT_QUERY
Default query name.
Protected fieldmCombineWithDefaultCulture
Combine the selection result with the default culture records?
Protected fieldmPreferredCultureCode
Preferred culture code for the data selection.
Protected fieldStatic membermProviderAssembly
Provider assembly.
Protected fieldStatic membermProviderAssemblyName
Provider assembly name.
Protected fieldmProviderObject
Search object instance.
Protected fieldmQueryParameters
Query parameters.
Protected fieldmSelectColumns
Select columns.
Protected fieldmSelectQueryName
Base query name to use for the document selection.
Protected fieldmUserInfo
Current user info object.
Public fieldStatic memberSECURITYCHECK_REQUIRED_COLUMNS
Columns required for the security check operation to perform successfully in any case.
Public fieldStatic memberSELECTNODES_REQUIRED_COLUMNS
Columns required for the select nodes operation to perform successfully in any case.
Public fieldStatic memberSELECTTREE_REQUIRED_COLUMNS
Columns required for the select tree operation to perform successfully in any case.
Top
Properties
  NameDescription
Public propertyAllowAsyncActions
Indicates whether asynchronous actions should be allowed (log synchronization tasks). By default it is set to TRUE.
Public propertyAutomaticallyUpdateDocumentAlias
If true, the document alias should be automatically updated upon document name change.
Public propertyBaseCacheKey
Provider base cache key.
Public propertyCombineWithDefaultCulture
Indicates if returned nodes should be combined with appropriate nodes of default culture in case they are not localized. It applies only if you're using multilingual support. The default value is false.
Public propertyDataSetFactory
DataSet factory, if set, the DataSet for the queried data is provided by this object
Public propertyDeleteChildNodes
If false, child nodes of the document are not deleted when the document is deleted. Default value is true.
Public propertyEnableBlogPostTrackbacks
Indicates whether blog post trackbacks are enabled.
Public propertyEnableDocumentAliases
Indicates whether "Remember original URL when moving document" option should be accepted.
Public propertyEnableNotifications
Indicates whether notifications are sent when content changes occur (document updated/inserted/deleted,...). By default it is set to TRUE.
Public propertyEnableRating
Indicates whether rating of a document should be updated. By default it is set to TRUE.
Public propertyEnsureSafeNodeAlias
If true, node alias will include only allowed characters (turn off only when you perform the validation by yourself or the source data are already valdiated).
Public propertyFilterOutDuplicates
If true, duplicate (linked) items are filtered.
Public propertyGenerateNewGuid
If true, new GUID is generated for the inserted nodes where required.
Public propertyHandleACLs
Indicates whether the ACL operations should be performed during the document operations.
Public propertyCheckUniqueAttachmentNames
If true, unique attachment names within one document are checked against the database. Turn off only when you perform the validation by yourself.
Public propertyCheckUniqueNames
If true, unique node names, document names and aliases are checked against the database. Turn off only when you perform the validation by yourself.
Public propertyKeepCheckedInOnInsert
If true, the document stays checked in on the insert operation
Public propertyLogEvents
If true, events are log on document update.
Public propertyLogIntegration
If true, integration tasks are logged on document update.
Public propertyLogSynchronization
If true, synchronization tasks are logged on document update.
Public propertyLogWebFarmTasks
If true, web farm tasks are logged on the object update.
Public propertyMergeResults
If true, tables from result DataSet are merged into a single table.
Public propertyPreferredCultureCode
Preferred culture code to use when none set.
Public propertyPreserveACLHierarchy
Indicates whether the ACL hierarchy should be preserved on processed documents.
Protected propertyStatic memberProviderAssemblyName
Custom provider library assembly.
Protected propertyProviderObject
Returns the provider object.
Public propertyQueryParameters
Query parameters for the select query.
Public propertySelectAllData
If true, all data are selected. Otherwise only base document data are selected.
Public propertySelectColumns
Columns returned by the select query.
Public propertySelectQueryName
Base query name to use for the document selection (for the enhanced selection options only).
Public propertySortMergedResults
If true, merged results are sorted.
Public propertyTouchCacheDependencies
If true, cache dependencies are touched on document update.
Public propertyUpdateDocumentContent
If true, document content is updated from internal objects.
Public propertyUpdateNodeData Obsolete.
If true, document content is updated from internal objects.
Public propertyUpdatePaths
If true, paths to the document are updated.
Public propertyUpdateSKUColumns
If true, SKU columns of the document are updated.
Public propertyUpdateTimeStamps
If true, time stamps of the document are updated.
Public propertyUpdateUser
If true, user IDs of the document (creator, modifier) are updated.
Public propertyUseAutomaticOrdering
If true, automatic ordering is used for new nodes.
Public propertyUseCache
If true, cache is used for documents data.
Public propertyUseCustomHandlers
If true, custom handlers are used with Document operations.
Public propertyUseParentNodeGroupID
Indicates whether NodeGroupID property should be set according to the parent value.
Public propertyUserInfo
Current user info.
Top
See Also