SiteMapProvider.RootProvider Proprietà

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

Ottiene l'oggetto SiteMapProvider radice della gerarchia di provider corrente.

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

Valore della proprietà

SiteMapProvider

Oggetto SiteMapProvider che rappresenta il provider di primo livello della mappa del sito nella gerarchia di provider a cui appartiene il provider corrente.

Eccezioni

ProviderException

Esiste un riferimento circolare al provider corrente della mappa del sito.

Esempio

Nell'esempio di codice seguente viene illustrato come implementare la RootProvider proprietà in una classe che implementa la classe astratta SiteMapProvider . SimpleTextSiteMapProvider Usa una logica semplice per determinare se il provider corrente fa parte di una gerarchia del provider. Se il provider fa parte di una gerarchia, usa la RootProvider proprietà per il provider padre come propria. Se il provider non fa parte di una gerarchia, il provider è il proprio provider radice.

Questo esempio di codice fa parte di un esempio più ampio fornito per la SiteMapProvider classe .

// 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

Commenti

Tutte le classi che implementano la SiteMapProvider classe possono supportare il concetto di gerarchia del provider della mappa del sito. Qualsiasi relazione gerarchica tra provider viene mantenuta all'esterno dell'ambito di una SiteMapProviderCollection raccolta da parte dei provider stessi. Per un esempio di gerarchia del provider funzionale, vedere XmlSiteMapProvider.

Vedi anche

• ParentProvider