ProviderBase.Initialize(String, NameValueCollection) Method

定義

構成ビルダーを初期化します。 Initializes the configuration builder.

public virtual void Initialize (string name, System.Collections.Specialized.NameValueCollection config);
パラメーター
name
String

プロバイダーのフレンドリ名。 The friendly name of the provider.

config
NameValueCollection

このプロバイダーの構成で指定された、プロバイダー固有の属性を表す名前と値のペアのコレクション。 A collection of the name/value pairs representing the provider-specific attributes specified in the configuration for this provider.

例外

プロバイダーの名前は null です。 The name of the provider is null.

プロバイダーの名前の長さは 0 です。 The name of the provider has a length of zero.

プロバイダーが既に初期化された後に、プロバイダーで Initialize(String, NameValueCollection) の呼び出しが試行されます。 An attempt is made to call Initialize(String, NameValueCollection) on a provider after the provider has already been initialized.

使用する方法の例についてはInitializeを参照してくださいプロファイル プロバイダーの実装例します。For an example of how to use Initialize, see Profile Provider Implementation Example.

注釈

基本クラスの実装がプロバイダーの内部で回数の合計には追跡Initializeメソッドが呼び出されました。The base class implementation internally tracks the number of times the provider's Initialize method has been called. プロバイダーが複数回初期化されている場合、InvalidOperationExceptionプロバイダーが既に初期化されていることを示すがスローされます。If a provider is initialized more than once, an InvalidOperationException is thrown stating that the provider is already initialized.

ほとんどの機能のプロバイダーの呼び出しのためInitializeプロバイダー固有の初期化を実行する前にこのメソッドは、二重の初期化を回避するための中央の場所。Because most feature providers call Initialize prior to performing provider-specific initialization, this method is a central location for preventing double initialization.

適用対象