SiteMapProvider.RootNode SiteMapProvider.RootNode SiteMapProvider.RootNode SiteMapProvider.RootNode Property

Определение

Получает корневой объект 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

Значение свойства

Корень SiteMapNode текущего поставщика данных карты веб-узла.The 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.

Применяется к

Дополнительно