ConfigurationManager クラスを使用すると、マシン構成情報、アプリケーション構成情報、およびユーザー構成情報にアクセスできます。このクラスは ConfigurationSettings クラスに代わるもので、優先して使用されます。
メモ : |
|---|
アプリケーションのホストによって異なるアプリケーション構成ファイルの名前と場所。詳細については、「アプリケーション構成ファイル」を参照してください。 |
System.Configuration の組み込みの型またはこれらの型から派生した型を使用して、構成情報を処理できます。これらの型を使用すると、構成情報を直接処理することが可能で、構成ファイルを拡張してカスタム情報を含めることもできます。
ConfigurationManager クラスには、次のタスクを実行できるメンバが含まれています。
構成ファイルからセクションを読み取ります。構成情報にアクセスするには、GetSection メソッドを呼び出します。appSettings や connectionStrings などの一部のセクションには、AppSettings クラスおよび ConnectionStrings クラスを使用します。これらのメンバは、読み取り専用の操作を実行し、構成のキャッシュされた 1 つのインスタンスを使用し、マルチスレッド対応です。
構成ファイル全体の読み取りと書き込みを行います。アプリケーションは、そのアプリケーション自体や他のアプリケーション、またはコンピュータのあらゆるレベルで、ローカルまたはリモートから構成設定の読み取りと書き込みを行うことができます。ConfigurationManager クラスに用意されているメソッドのいずれかを使用して、SampleApp.exe.config などの構成ファイルを開くことができます。これらのメソッドは、Configuration オブジェクトを返します。このオブジェクトは、関連付けられている構成ファイルの処理に使用できるメソッドとプロパティを公開します。メソッドは、読み取り操作または書き込み操作を実行し、ファイルに書き込みが行われるたびに構成データを作成します。
構成タスクをサポートします。次の型を使用して、さまざまな構成タスクをサポートします。
既存の構成情報の処理に加え、ConfigurationElement、ConfigurationElementCollection、ConfigurationProperty、ConfigurationSection の各クラスなど、組み込みの構成の種類を拡張することによって、カスタム構成要素を作成し使用できます。組み込みの構成の種類をプログラムによって拡張する方法の例については、ConfigurationSection に関するトピックを参照してください。属性ベースのモデルを使用する、組み込みの構成の種類を拡張する方法の例については、ConfigurationElement に関するトピックを参照してください。
実装元へのメモ :Configuration クラスは、構成ファイルの編集をプログラムから行うことができるようにします。ConfigurationManager によって提供された、Open メソッドの 1 つを使用します。これらのメソッドは、Configuration オブジェクトを返します。このオブジェクトにより、基になる構成ファイルを処理するために必要なメソッドとプロパティが提供されます。これらのファイルへの読み取りアクセスまたは書き込みアクセスができます。
構成ファイルを読み取るには、GetSection または GetSectionGroup を使用して構成情報を読み取ります。読み取りを行うユーザーまたはプロセスに、次のアクセス許可が必要です。
アプリケーションが独自の構成に対する読み取り専用アクセスを行う必要がある場合は、GetSection メソッドを使用することをお勧めします。これらのメソッドにより、現在のアプリケーションのキャッシュされた構成値にアクセスできます。こちらの方が、Configuration クラスよりもパフォーマンスが優れています。
構成ファイルへの書き込みを行うには、Save メソッドのいずれかを使用します。書き込みを行うユーザーまたはプロセスに、次のアクセス許可が必要です。