System.Configuration.Provider.ProviderBase.Initialize 方法

方法描述

初始化提供程序。

语法定义(C# System.Configuration.Provider.ProviderBase.Initialize 方法 的用法)

public virtual void Initialize(
	string name,
	NameValueCollection config
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
name System-String 该提供程序的友好名称。
config System-Collections-Specialized-NameValueCollection 名称/值对的集合,表示在配置中为该提供程序指定的、提供程序特定的特性。
返回值 void

提示和注释

此基类实现会对提供程序的 Initialize 方法的调用次数进行内部跟踪。 如果多次初始化一个提供程序,将引发 InvalidOperationException,说明此提供程序已被初始化。

由于大部分功能提供程序在执行提供程序特定的初始化之前,会调用 Initialize,因此此方法是防止重复初始化的核心位置。

System.Configuration.Provider.ProviderBase.Initialize 方法例子

有关如何使用 Initialize 的示例,请参见配置文件提供程序实现示例。


异常

异常 异常描述
ArgumentNullException 提供程序的名称是 null。
ArgumentException 提供程序的名称长度为零。
InvalidOperationException 提供程序初始化完成后,将尝试调用该提供程序上的 Initialize。

命名空间

namespace: System.Configuration.Provider

程序集: System.Configuration(在 System.Configuration.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。