ProviderBase.Initialize(String, NameValueCollection) Metodo

Definizione

Spazio dei nomi:

System.Configuration.Provider

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

ProviderBase.cs

Inizializza il generatore di configurazione.

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

Nome descrittivo del provider.

config

NameValueCollection

Raccolta delle coppie nome/valore che rappresentano gli attributi specifici del provider specificati nella configurazione per il provider.

Eccezioni

ArgumentNullException

Il nome del provider è null.

ArgumentException

Il nome del provider ha lunghezza zero.

InvalidOperationException

Viene effettuato un tentativo di chiamare Initialize(String, NameValueCollection) su un provider dopo che il provider è già stato inizializzato.

Esempio

Per un esempio di come usare Initialize, vedere Esempio di implementazione del provider di profili.

Commenti

L'implementazione della classe di base tiene traccia internamente del numero di chiamate al metodo del Initialize provider. Se un provider viene inizializzato più volte, viene generata un'eccezione InvalidOperationException che indica che il provider è già inizializzato.

Poiché la maggior parte dei provider di funzionalità chiama Initialize prima di eseguire l'inizializzazione specifica del provider, questo metodo è una posizione centrale per impedire l'inizializzazione doppia.

Vedi anche

• Esempio di implementazione del provider di profili
• Esempio di implementazione del provider di configurazione protetta
• Procedura: Implementazione del provider di appartenenze di esempio
• Procedura: Implementazione di Role-Provider di esempio