SiteMapProviderCollection.Add Metodo

Definizione

Aggiunge un provider della mappa del sito alla raccolta SiteMapProviderCollection.

Overload

Add(ProviderBase)

Aggiunge un elemento SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.

Add(SiteMapProvider)

Aggiunge un oggetto SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.

Add(ProviderBase)

Aggiunge un elemento SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.

public:
 override void Add(System::Configuration::Provider::ProviderBase ^ provider);
public override void Add (System.Configuration.Provider.ProviderBase provider);
override this.Add : System.Configuration.Provider.ProviderBase -> unit
Public Overrides Sub Add (provider As ProviderBase)

Parametri

provider
ProviderBase

Oggetto SiteMapProvider da aggiungere.

Eccezioni

L'elemento Name di SiteMapProvider è null.

provider non è un'istanza della classe SiteMapProvider.

-oppure-

Un elemento SiteMapProvider con lo stesso nome è già presente in SiteMapProviderCollection.

La classe SiteMapProviderCollection è di sola lettura.

Commenti

L'oggetto SiteMapProviderCollection restituito dalla Providers proprietà è di sola lettura. Per questo motivo, non è possibile usare i Add metodi e AddArray per aggiungere altri provider a livello di codice in fase di esecuzione. Pertanto, i Add metodi e AddArray vengono usati solo negli scenari in cui si creano manualmente oggetti provider della mappa del sito e li si gestisce con un'istanza della SiteMapProviderCollection classe . Il Add(ProviderBase) metodo controlla il tipo del provider specificato e quindi chiama il Add(SiteMapProvider) metodo per aggiungerlo alla raccolta.

Poiché la SiteMap classe è statica, qualsiasi SiteMapProvider contenuto nella raccolta Providers rimane per tutta la durata dell'applicazione Web.

Vedi anche

Si applica a

Add(SiteMapProvider)

Aggiunge un oggetto SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.

public:
 void Add(System::Web::SiteMapProvider ^ provider);
public void Add (System.Web.SiteMapProvider provider);
override this.Add : System.Web.SiteMapProvider -> unit
Public Sub Add (provider As SiteMapProvider)

Parametri

provider
SiteMapProvider

Oggetto SiteMapProvider da aggiungere.

Eccezioni

provider è null.

La classe SiteMapProviderCollection è di sola lettura.

Un elemento SiteMapProvider con lo stesso nome è già presente in SiteMapProviderCollection.

Commenti

L'oggetto SiteMapProviderCollection restituito dalla Providers proprietà è di sola lettura. Per questo motivo, non è possibile usare i Add metodi e AddArray per aggiungere altri provider a livello di codice a in SiteMap fase di esecuzione. Pertanto, i Add metodi e AddArray vengono usati solo negli scenari in cui si creano manualmente oggetti provider della mappa del sito e li si gestisce con un'istanza della SiteMapProviderCollection classe . Usare il Add metodo quando si desidera aggiungere un singolo SiteMapProvider oggetto all'oggetto SiteMapProviderCollection.

Poiché la SiteMap classe è statica, qualsiasi SiteMapProvider contenuto nella raccolta Providers rimane per tutta la durata dell'applicazione Web.

Vedi anche

Si applica a