ProviderBase.Initialize(String, NameValueCollection) Methode

Definition

Namespace:

System.Configuration.Provider

Assembly:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Quelle:

ProviderBase.cs

Initialisiert den Konfigurations-Generator.

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)

Parameter

name

String

Der Anzeigename des Anbieters.

config

NameValueCollection

Eine Auflistung der Name-Wert-Paare, die in der Konfiguration für diesen Anbieter die anbieterspezifischen Attribute darstellen.

Ausnahmen

ArgumentNullException

Der Name des Anbieters lautet null.

ArgumentException

Der Name des Anbieters weist die Länge 0 (null) auf.

InvalidOperationException

Es wurde versucht, Initialize(String, NameValueCollection) für einen Anbieter aufzurufen, nachdem der Anbieter bereits initialisiert wurde.

Beispiele

Ein Beispiel für die Verwendung Initializefinden Sie unter Beispiel für die Implementierung von Profilanbietern.

Hinweise

Die Basisklassenimplementierung verfolgt intern nach, wie oft die Methode des Anbieters Initialize aufgerufen wurde. Wenn ein Anbieter mehr als einmal initialisiert wird, wird ein InvalidOperationException ausgelöst, der besagt, dass der Anbieter bereits initialisiert wurde.

Da die meisten Featureanbieter vor der Durchführung der anbieterspezifischen Initialisierung aufrufen Initialize , ist diese Methode ein zentraler Ort, um doppelte Initialisierung zu verhindern.

Weitere Informationen

• Beispiel für die Profilanbieterimplementierung
• Beispiel für die Implementierung des geschützten Konfigurationsanbieters
• Vorgehensweise: Beispielimplementierung des Mitgliedschaftsanbieters
• Vorgehensweise: Beispielimplementierung Role-Provider