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

プロバイダーの名前の長さは 0 です。

InvalidOperationException

プロバイダーが既に初期化された後に、プロバイダーで Initialize(String, NameValueCollection) の呼び出しが試行されます。

例

の使用方法 Initializeの例については、「 プロファイル プロバイダーの実装例」を参照してください。

注釈

基底クラスの実装は、プロバイダーのメソッドが呼び出された回数を内部的に追跡します Initialize 。 プロバイダーが複数回初期化されると、 InvalidOperationException プロバイダーが既に初期化されていることを示す がスローされます。

ほとんどの機能プロバイダーはプロバイダー固有の初期化を実行する前に を呼び出 Initialize すので、このメソッドは二重初期化を防ぐための中心的な場所です。

こちらもご覧ください

• プロファイル プロバイダーの実装例
• 保護された構成プロバイダーの実装例
• 方法: メンバーシップ プロバイダーの実装のサンプル
• 方法: Role-Provider実装のサンプル