ProviderBase.Initialize メソッド

.NET Framework クラス ライブラリ リファレンス

ProviderBase.Initialize メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

プロバイダを初期化します。

名前空間: System.Configuration.Provider
アセンブリ: System.Configuration (system.configuration.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub Initialize
 ( _
    name As String, _
    config As NameValueCollection _
)

Visual Basic (使用法)

Dim instance As ProviderBase
Dim name As String
Dim config As NameValueCollection

instance.Initialize(name, config)

C#

public virtual void Initialize (
    string name,
    NameValueCollection config
)

C++

public:
virtual void Initialize (
    String^ name, 
    NameValueCollection^ config
)

J#

public void Initialize (
    String name, 
    NameValueCollection config
)

JScript

public function Initialize (
    name : String, 
    config : NameValueCollection
)

パラメータ

name

プロバイダの表示名。

config

このプロバイダの構成で指定されている、プロバイダ固有の属性を表す名前と値のペアのコレクション。

例外

例外の種類	条件
ArgumentNullException	プロバイダの名前が null 参照 (Visual Basic では Nothing) です。
ArgumentException	プロバイダの名前の長さが 0 です。
InvalidOperationException	プロバイダが既に初期化された後に、プロバイダに対して Initialize が呼び出されました。

解説

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

ほとんどの機能のプロバイダではプロバイダ固有の初期化の実行前に Initialize が呼び出されるため、このメソッドは、重複した初期化を防ぐための中核部分です。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ProviderBase クラス
ProviderBase メンバ
System.Configuration.Provider 名前空間