SiteMapProviderCollection.AddArray(SiteMapProvider[]) Method

Definition

Aggiunge una matrice di oggetti SiteMapProvider alla raccolta di provider usando le proprietà Name come chiavi.Adds an array of SiteMapProvider objects into the provider collection using the Name properties as keys.

public:
 void AddArray(cli::array <System::Web::SiteMapProvider ^> ^ providerArray);
public void AddArray (System.Web.SiteMapProvider[] providerArray);
member this.AddArray : System.Web.SiteMapProvider[] -> unit
Public Sub AddArray (providerArray As SiteMapProvider())

Parameters

providerArray
SiteMapProvider[]

Matrice di oggetti SiteMapProvider da aggiungere.The array of SiteMapProvider objects to add.

Exceptions

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

providerArray è null.providerArray is null.

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

Remarks

Il SiteMapProviderCollection restituito dalla proprietà Providers è di sola lettura.The SiteMapProviderCollection 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 only used in scenarios where you manually create site map provider objects and manage them with an instance of the SiteMapProviderCollection class.

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.

Applies to

See also