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 實作