StaticSiteMapProvider.GetParentNode(SiteMapNode) メソッド

定義

特定の 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

パラメーター

node
SiteMapNode

親サイト マップ ノードを取得する対象の SiteMapNodeThe SiteMapNode for which to retrieve the parent site map node.

戻り値

SiteMapNode

指定した SiteMapNode の親を表す SiteMapNode。親サイト マップ ノードが存在しない場合、または親サイト マップ ノードの表示がユーザーに許可されていない場合は nullA 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.

例外

nodenullです。node is null.

注釈

オブジェクトは、 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.

適用対象

こちらもご覧ください