StaticSiteMapProvider.GetParentNode(SiteMapNode) Method

Definition

Представляет родительский узел карты веб-узла указанного объекта SiteMapNode.Retrieves the parent site map node of a specific SiteMapNode object.

public:
 override System::Web::SiteMapNode ^ GetParentNode(System::Web::SiteMapNode ^ node);
public override System.Web.SiteMapNode GetParentNode (System.Web.SiteMapNode node);
override this.GetParentNode : System.Web.SiteMapNode -> System.Web.SiteMapNode
Public Overrides Function GetParentNode (node As SiteMapNode) As SiteMapNode

Parameters

node
SiteMapNode

Объект SiteMapNode, для которого нужно извлечь родительский узел карты веб-узла.The SiteMapNode for which to retrieve the parent site map node.

Returns

SiteMapNode

Объект SiteMapNode, который представляет родительский элемент указанного объекта SiteMapNode; в противном случае — значение null, если родительский узел карты веб-узла не существует или пользователь не имеет доступа для просмотра родительского узла карты веб-узла.A SiteMapNode that represents the parent of the specified SiteMapNode; otherwise, null, if no parent site map node exists or the user is not permitted to see the parent site map node.

Exceptions

Свойство node имеет значение null.node is null.

Remarks

SiteMapNode объекты делегируются поставщику карт узла, чтобы контролировать их дочерние и родительские узлы карт узла.The SiteMapNode objects delegate to the site map provider to keep track of their child and parent site map nodes. В результате классы, реализующие поставщик карт веб-узла для иерархической структуры карт узла, например класс StaticSiteMapProvider, и используют SiteMapNode объекты для представления узлов карт узла, должны относить иерархические связи всех узлов карт узла, чтобы иметь возможность перемещаться по всему иерархическому дереву.As a result, classes that implement a site map provider for a hierarchical site map structure, such as the StaticSiteMapProvider class, and use SiteMapNode objects to represent site map nodes, must track the hierarchical relationships of all site map nodes in order to be able to navigate an entire hierarchical tree.

Если свойство ParentNode не найдено, класс StaticSiteMapProvider определяет, имеет ли текущий поставщик узла свойство ParentProvider.If a ParentNode property is not found, the StaticSiteMapProvider class detects whether the current site map provider has a ParentProvider property. Если это так, поставщик карт узла вызывает свойство GetParentNode для родительского поставщика карт веб-сайта.If so, the site map provider calls the GetParentNode property for the parent site map provider. Это позволяет сценарию, где родительский узел схемы узла узла схемы узла поддерживает другой поставщик карт сайта.This enables the scenario where the parent site map node of a site map node is maintained by a different site map provider.

Метод GetParentNode вызывает метод BuildSiteMap внутренне для получения SiteMapNode, представляющего родителя указанного узла схемы узла.The GetParentNode method calls the BuildSiteMap method internally to retrieve the SiteMapNode that represents the parent of the specified site map node. Если фильтрация по безопасности включена, узел "схема узла" возвращается только в том случае, если пользователю разрешено его просматривать.If security trimming is enabled, the site map node is returned only if the user is permitted to see it.

Applies to

See also