XmlSiteMapProvider.RootNode プロパティ


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

 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。セキュリティ トリミングが有効で、現在のユーザーがルート ノードにアクセスできない場合は 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 抽象プロパティをオーバーライド SiteMapProvider.RootNode し、ルートノードを追跡するための単純な実装を提供します。The XmlSiteMapProvider class overrides the abstract SiteMapProvider.RootNode property and provides a simple implementation to track the root node.