ProviderBase.Initialize(String, NameValueCollection) ProviderBase.Initialize(String, NameValueCollection) ProviderBase.Initialize(String, NameValueCollection) ProviderBase.Initialize(String, NameValueCollection) Method

Definizione

Inizializza il generatore di configurazione.Initializes the configuration builder.

public:
 virtual void Initialize(System::String ^ name, System::Collections::Specialized::NameValueCollection ^ config);
public virtual void Initialize (string name, System.Collections.Specialized.NameValueCollection config);
abstract member Initialize : string * System.Collections.Specialized.NameValueCollection -> unit
override this.Initialize : string * System.Collections.Specialized.NameValueCollection -> unit
Public Overridable Sub Initialize (name As String, config As NameValueCollection)

Parametri

name
String String String String

Nome descrittivo del provider.The friendly name of the provider.

config
NameValueCollection NameValueCollection NameValueCollection NameValueCollection

Raccolta delle coppie nome/valore che rappresentano gli attributi specifici del provider specificati nella configurazione per il provider.A collection of the name/value pairs representing the provider-specific attributes specified in the configuration for this provider.

Eccezioni

Il nome del provider è null.The name of the provider is null.

Il nome del provider ha lunghezza zero.The name of the provider has a length of zero.

Viene effettuato un tentativo di chiamare Initialize(String, NameValueCollection) su un provider dopo che il provider è già stato inizializzato.An attempt is made to call Initialize(String, NameValueCollection) on a provider after the provider has already been initialized.

Esempi

Per un esempio di come usare Initialize, vedere esempio di implementazione del provider di profili.For an example of how to use Initialize, see Profile Provider Implementation Example.

Commenti

L'implementazione della classe di base rileva internamente il numero di volte Initialize in cui è stato chiamato il metodo del provider.The base class implementation internally tracks the number of times the provider's Initialize method has been called. Se un provider viene inizializzato più di una volta InvalidOperationException , viene generata un'eccezione che indica che il provider è già inizializzato.If a provider is initialized more than once, an InvalidOperationException is thrown stating that the provider is already initialized.

Poiché la maggior parte dei Initialize provider di funzionalità chiama prima di eseguire l'inizializzazione specifica del provider, questo metodo è una posizione centrale per impedire l'inizializzazione doppia.Because most feature providers call Initialize prior to performing provider-specific initialization, this method is a central location for preventing double initialization.

Si applica a

Vedi anche