SiteMapProviderCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

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

ArgumentNullException

L'elemento Name di SiteMapProvider è null.

ArgumentException

provider non è un'istanza della classe SiteMapProvider.

-oppure-

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

NotSupportedException

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

• AddArray(SiteMapProvider[])

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

ArgumentNullException

provider è null.

NotSupportedException

La classe SiteMapProviderCollection è di sola lettura.

ArgumentException

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

• Add(ProviderBase)