SiteMapProvider.RootNode プロパティ

定義

現在のプロバイダーが示すサイト マップ データのルート SiteMapNode オブジェクトを取得します。Gets the root SiteMapNode object of the site map data that the current provider represents.

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

プロパティ値

現在のサイト マップ データ プロバイダーのルート SiteMapNodeThe root SiteMapNode of the current site map data provider. 既定の実装は、返されたノードに対してセキュリティ トリミングが実行されます。The default implementation performs security trimming on the returned node.

次のコード例は、抽象RootNode SiteMapProviderクラスを実装するクラスにプロパティを実装する方法を示しています。The following code example demonstrates how to implement the RootNode property in a class that implements the abstract SiteMapProvider class.

このコード例は、 SiteMapProviderクラスに対して提供される大規模な例の一部です。This code example is part of a larger example provided for the SiteMapProvider class.

// Implement the CurrentNode property.
public override SiteMapNode CurrentNode
{
  get
  {
    string currentUrl = FindCurrentUrl();
    // Find the SiteMapNode that represents the current page.
    SiteMapNode currentNode = FindSiteMapNode(currentUrl);
    return currentNode;
  }
}

// Implement the RootNode property.
public override SiteMapNode RootNode
{
  get
  {
    return rootNode;
  }
}
' Implement the CurrentNode property.
Public Overrides ReadOnly Property CurrentNode() As SiteMapNode
  Get
    Dim currentUrl As String = FindCurrentUrl()
    ' Find the SiteMapNode that represents the current page.
    Dim aCurrentNode As SiteMapNode = FindSiteMapNode(currentUrl)
    Return aCurrentNode
  End Get
End Property

' Implement the RootNode property.
Public Overrides ReadOnly Property RootNode() As SiteMapNode
  Get
    Return aRootNode
  End Get
End Property

注釈

既定の実装は、抽象GetRootNodeCoreメソッドを呼び出します。The default implementation calls the abstract GetRootNodeCore method.

注意 (継承者)

派生クラスのRootNodeプロパティをオーバーライドする場合は、実装がプロバイダー階層 (存在する場合) に移動してサイトの絶対ルートノードを検索しないようにしてください。When overriding the RootNode property in a derived class, be sure that the implementation does not navigate the provider hierarchy, if one exists, to find the absolute root node of the site.

適用対象

こちらもご覧ください