SiteMapProvider.RootProvider SiteMapProvider.RootProvider SiteMapProvider.RootProvider SiteMapProvider.RootProvider Property

Definition

Ruft das SiteMapProvider-Stammobjekt in der aktuellen Anbieterhierarchie ab.Gets the root SiteMapProvider object in the current provider hierarchy.

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

Eigenschaftswert

Ein SiteMapProvider, der der Siteübersichtsanbieter der obersten Ebene in der Anbieterhierarchie ist, zu der der aktuelle Anbieter gehört.An SiteMapProvider that is the top-level site map provider in the provider hierarchy that the current provider belongs to.

Ausnahmen

Es ist ein Zirkelverweis auf den aktuellen Siteübersichtsanbieter vorhanden.There is a circular reference to the current site map provider.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die RootProvider -Eigenschaft in einer Klasse implementiert wird, SiteMapProvider die die abstrakte-Klasse implementiert.The following code example demonstrates how to implement the RootProvider property in a class that implements the abstract SiteMapProvider class. SimpleTextSiteMapProvider Verwendet einfache Logik, um zu bestimmen, ob der aktuelle Anbieter Teil einer Anbieter Hierarchie ist.The SimpleTextSiteMapProvider uses simple logic to determine whether the current provider is part of a provider hierarchy. Wenn der Anbieter Teil einer Hierarchie ist, wird die RootProvider -Eigenschaft für den übergeordneten Anbieter als eigener Anbieter verwendet.If the provider is part of a hierarchy, it uses the RootProvider property for the parent provider as its own. Wenn der Anbieter nicht Teil einer Hierarchie ist, ist der Anbieter sein eigener Stamm Anbieter.If the provider is not part of a hierarchy, the provider is its own root provider.

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SiteMapProvider -Klasse bereitgestellt wird.This code example is part of a larger example provided for the SiteMapProvider class.

// Implement the ParentProvider property.
public override SiteMapProvider ParentProvider
{
  get
  {
    return parentSiteMapProvider;
  }
  set
  {
    parentSiteMapProvider = value;
  }
}

// Implement the RootProvider property.
public override SiteMapProvider RootProvider
{
  get
  {
    // If the current instance belongs to a provider hierarchy, it
    // cannot be the RootProvider. Rely on the ParentProvider.
    if (this.ParentProvider != null)
    {
      return ParentProvider.RootProvider;
    }
    // If the current instance does not have a ParentProvider, it is
    // not a child in a hierarchy, and can be the RootProvider.
    else
    {
      return this;
    }
  }
}
' Implement the ParentProvider property.
Public Overrides Property ParentProvider() As SiteMapProvider
  Get
    Return parentSiteMapProvider
  End Get
  Set(ByVal value As SiteMapProvider)
    parentSiteMapProvider = Value
  End Set
End Property

' Implement the RootProvider property.
Public Overrides ReadOnly Property RootProvider() As SiteMapProvider
  Get
    ' If the current instance belongs to a provider hierarchy, it
    ' cannot be the RootProvider. Rely on the ParentProvider.
    If Not (Me.ParentProvider Is Nothing) Then
      Return ParentProvider.RootProvider
      ' If the current instance does not have a ParentProvider, it is
      ' not a child in a hierarchy, and can be the RootProvider.
    Else
      Return Me
    End If
  End Get
End Property

Hinweise

Alle Klassen, die die SiteMapProvider -Klasse implementieren, können das Konzept einer Site Übersichts Anbieter Hierarchie unterstützen.All classes that implement the SiteMapProvider class can support the concept of a site map provider hierarchy. Alle hierarchischen Beziehungen zwischen Anbietern werden von den Anbietern selbst außerhalb SiteMapProviderCollection des Bereichs einer Sammlung verwaltet.Any hierarchical relationships between providers are maintained outside the scope of a SiteMapProviderCollection collection by the providers themselves. Ein Beispiel für eine Funktions Anbieter Hierarchie finden XmlSiteMapProviderSie unter.For an example of a functional provider hierarchy, see XmlSiteMapProvider.

Gilt für:

Siehe auch