SiteMapProviderCollection.Add Metodo

Definizione

Aggiunge un provider della mappa del sito alla raccolta SiteMapProviderCollection.Adds a site map provider to the SiteMapProviderCollection collection.

Overload

Add(ProviderBase)

Aggiunge un elemento SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.Adds a SiteMapProvider to the provider collection using the Name property as the key.

Add(SiteMapProvider)

Aggiunge un oggetto SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.Adds a SiteMapProvider object to the provider collection using the Name property as the key.

Add(ProviderBase)

Aggiunge un elemento SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.Adds a SiteMapProvider to the provider collection using the Name property as the key.

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.The SiteMapProvider to add.

Eccezioni

L'elemento Name di SiteMapProvider è null.The Name of the SiteMapProvider is null.

provider non è un'istanza della classe SiteMapProvider.provider is not an instance of the SiteMapProvider class.

In alternativa-or- Un elemento SiteMapProvider con lo stesso nome è già presente in SiteMapProviderCollection.A SiteMapProvider with the same name already exists in the SiteMapProviderCollection.

La classe SiteMapProviderCollection è di sola lettura.The SiteMapProviderCollection is read-only.

Commenti

L' SiteMapProviderCollection oggetto restituito Providers dalla proprietà è di sola lettura.The SiteMapProviderCollection object that is returned by the Providers property is read-only. Per questo motivo, non è possibile usare Add i AddArray metodi e per aggiungere altri provider a livello di codice in fase di esecuzione.For this reason, you cannot use the Add and AddArray methods to add additional providers programmatically at run time. Pertanto, i Add metodi AddArray e vengono utilizzati solo negli scenari in cui è possibile creare manualmente oggetti provider della mappa del sito e gestirli SiteMapProviderCollection con un'istanza della classe.Therefore, the Add and AddArray methods are used only in scenarios where you manually create site map provider objects and manage them with an instance of the SiteMapProviderCollection class. Il Add(ProviderBase) metodo controlla il tipo del provider specificato, quindi chiama il Add(SiteMapProvider) metodo per aggiungerlo alla raccolta.The Add(ProviderBase) method checks the type of the specified provider, and then calls the Add(SiteMapProvider) method to add it to the collection.

Poiché la SiteMap classe è statica, qualsiasi SiteMapProvider contenuto nella relativa Providers raccolta rimane per la durata dell'applicazione Web.Because the SiteMap class is static, any SiteMapProvider contained in its Providers collection remains for the lifetime of the Web application.

Vedi anche

Add(SiteMapProvider)

Aggiunge un oggetto SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.Adds a SiteMapProvider object to the provider collection using the Name property as the key.

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.The SiteMapProvider to add.

Eccezioni

provider è null.provider is null.

La classe SiteMapProviderCollection è di sola lettura.The SiteMapProviderCollection is read-only.

Un elemento SiteMapProvider con lo stesso nome è già presente in SiteMapProviderCollection.A SiteMapProvider with the same name already exists in the SiteMapProviderCollection.

Commenti

L' SiteMapProviderCollection oggetto restituito Providers dalla proprietà è di sola lettura.The SiteMapProviderCollection object that is returned by the Providers property is read-only. Per questo motivo, non è possibile usare Add i AddArray metodi e per SiteMap aggiungere a livello di codice ulteriori provider a in fase di esecuzione.For this reason, you cannot use the Add and AddArray methods to programmatically add additional providers to the SiteMap at run time. Pertanto, i Add metodi AddArray e vengono utilizzati solo negli scenari in cui è possibile creare manualmente oggetti provider della mappa del sito e gestirli SiteMapProviderCollection con un'istanza della classe.Therefore, the Add and AddArray methods are used only in scenarios where you manually create site map provider objects and manage them with an instance of the SiteMapProviderCollection class. Utilizzare il Add metodo quando si desidera aggiungere un singolo SiteMapProvider oggetto a SiteMapProviderCollection.Use the Add method when you want to add a single SiteMapProvider to the SiteMapProviderCollection.

Poiché la SiteMap classe è statica, qualsiasi SiteMapProvider contenuto nella relativa Providers raccolta rimane per la durata dell'applicazione Web.Because the SiteMap class is static, any SiteMapProvider contained in its Providers collection remains for the lifetime of the Web application.

Vedi anche

Si applica a