XmlSiteMapProvider.RootNode プロパティ

定義

サイト マップのルート ノードを取得します。Gets the root node of the site map.

public:
 virtual property System::Web::SiteMapNode ^ RootNode { System::Web::SiteMapNode ^ get(); };
public override System.Web.SiteMapNode RootNode { get; }
member this.RootNode : System.Web.SiteMapNode
Public Overrides ReadOnly Property RootNode As SiteMapNode

プロパティ値

SiteMapNode

サイト マップのルート ノードを表す SiteMapNode。セキュリティ トリミングが有効で、現在のユーザーがルート ノードにアクセスできない場合は nullA SiteMapNode that represents the root node of the site map; otherwise, null, if security trimming is enabled and the root node is not accessible to the current user.

注釈

RootNode プロパティは、BuildSiteMap メソッドを呼び出して、サイトマップ内の最上位ノードを取得します。The RootNode property calls the BuildSiteMap method to retrieve the top-level node in the site map. したがって、BuildSiteMap メソッドで発生した例外は、RootNode プロパティにアクセスするときにも発生する可能性があります。Therefore, any exceptions that occur for the BuildSiteMap method can also occur when accessing the RootNode property.

SiteMapProvider クラスと XmlSiteMapProvider クラスでは、サイトマップ内のルート SiteMapNode オブジェクトが1つだけ許可されます。The SiteMapProvider and XmlSiteMapProvider classes permit only one root SiteMapNode object in a site map. XmlSiteMapProvider クラスは、abstract SiteMapProvider.RootNode プロパティをオーバーライドし、ルートノードを追跡するための単純な実装を提供します。The XmlSiteMapProvider class overrides the abstract SiteMapProvider.RootNode property and provides a simple implementation to track the root node.

適用対象

こちらもご覧ください