ProviderBase.Initialize(String, NameValueCollection) Метод

Определение

Пространство имен:

System.Configuration.Provider

Сборка:

System.Configuration.ConfigurationManager.dll

Пакет:

System.Configuration.ConfigurationManager v8.0.0

Исходный код:

ProviderBase.cs

Инициализирует построитель конфигураций.

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)

Параметры

name

String

Понятное имя поставщика.

config

NameValueCollection

Коллекция пар "имя-значение", представляющих атрибуты поставщика, указанные в конфигурации для этого поставщика.

Исключения

ArgumentNullException

Имя поставщика: null.

ArgumentException

Имя поставщика имеет нулевую длину.

InvalidOperationException

Предпринятая попытка вызвать Initialize(String, NameValueCollection) в поставщике после инициализации поставщика.

Примеры

Пример использования Initializeсм. в разделе Пример реализации поставщика профилей.

Комментарии

Реализация базового класса внутренне отслеживает количество вызовов метода поставщика Initialize . Если поставщик инициализируется несколько раз, возникает исключение , InvalidOperationException указывающее, что поставщик уже инициализирован.

Так как большинство поставщиков функций вызывают Initialize до выполнения инициализации конкретного поставщика, этот метод является центральным местом для предотвращения двойной инициализации.

См. также раздел

• Пример реализации поставщика профилей
• Пример реализации поставщика защищенной конфигурации
• Практическое руководство. Пример реализации поставщика членства
• Практическое руководство. Пример реализации Role-Provider