ProviderBase.Initialize(String, NameValueCollection) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
Il nome del provider è null
.
Il nome del provider ha lunghezza zero.
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.