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

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.

-oppure--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'oggetto SiteMapProviderCollection restituito dalla proprietà Providers è di sola lettura.The SiteMapProviderCollection object that is returned by the Providers property is read-only. Per questo motivo, non è possibile usare i metodi Add e AddArray 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. I metodi Add e AddArray vengono pertanto utilizzati solo negli scenari in cui è possibile creare manualmente oggetti provider della mappa del sito e gestirli con un'istanza della classe SiteMapProviderCollection.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 metodo Add(ProviderBase) controlla il tipo del provider specificato, quindi chiama il metodo Add(SiteMapProvider) 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 classe SiteMap è statica, qualsiasi SiteMapProvider contenuto nella raccolta di Providers 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

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'oggetto SiteMapProviderCollection restituito dalla proprietà Providers è di sola lettura.The SiteMapProviderCollection object that is returned by the Providers property is read-only. Per questo motivo, non è possibile usare i metodi Add e AddArray per aggiungere a livello di codice ulteriori provider al SiteMap 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. I metodi Add e AddArray vengono pertanto utilizzati solo negli scenari in cui è possibile creare manualmente oggetti provider della mappa del sito e gestirli con un'istanza della classe SiteMapProviderCollection.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 metodo Add quando si desidera aggiungere un singolo SiteMapProvider al SiteMapProviderCollection.Use the Add method when you want to add a single SiteMapProvider to the SiteMapProviderCollection.

Poiché la classe SiteMap è statica, qualsiasi SiteMapProvider contenuto nella raccolta di Providers 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