ProviderBase.Initialize(String, NameValueCollection) 方法

定义

命名空间:

System.Configuration.Provider

程序集:

System.Configuration.ConfigurationManager.dll

包:

System.Configuration.ConfigurationManager v8.0.0

Source:

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 实现