方法: アプリケーション設定を読み取る

2025-06-17

注

この記事は .NET Framework に固有のものです。 .NET 6 以降のバージョンを含む、.NET の新しい実装には適用されません。

この記事では、.NET Framework アプリの App.config ファイルに単純な設定を追加し、プログラムで値を読み取る方法について説明します。単一の値を読み取るのではなく、セクション全体またはファイル全体を読み取ることができます。詳細な例と情報については、 ConfigurationManager ドキュメントを参照してください。

App.config ファイルを追加する

Visual Studio を使用すると、 App.config ファイルをプロジェクトに簡単に追加できます。 .NET Framework プロジェクトを作成した後、 ソリューションエクスプローラー でプロジェクトを右クリックし、[ 追加>新しい項目] を選択します。 [ アプリケーション構成ファイル ] 項目を選択し、[ 追加] を選択します。

設定を追加する

App.config ファイルを開き、<configuration>要素内に次の XML を追加します。

  <appSettings>
    <add key="occupation" value="dentist"/>
  </appSettings>

プログラムで設定にアクセスする

コード内の設定の値にアクセスするには、 AppSettings プロパティにインデックスを作成して値を取得します。 AppSettings プロパティを使用すると、構成ファイルの<appSettings>要素からデータを簡単に取得できます。

string occupation = ConfigurationManager.AppSettings["occupation"];

ライブラリの構成

実行可能アプリに構成ファイルを使用するのは簡単ですが、クラスライブラリではもう少し複雑です。クラスライブラリは実行可能アプリと同じ方法で構成設定にアクセスできますが、構成設定はクライアントアプリの App.config ファイルに存在する必要があります。 App.config ファイルをライブラリのアセンブリファイルと共に配布しても、ライブラリコードはファイルを読み取りません。または、クラスライブラリで構成設定を使用する次の方法を検討してください。

クライアントアプリで構成設定を取得し、クラスライブラリからインスタンス化するクラスに渡します。
ConfigurationSection クラスを拡張するカスタムセクション型を実装します。クラスライブラリ用の個別の構成ファイルを保持し、クライアントアプリの構成ファイルからライブラリの構成ファイルを参照します。詳細については、「方法: ConfigurationSection を使用してカスタム構成セクションを作成する」を参照してください。

こちらも参照ください

System.Configuration.ConfigurationManager