C#での設定ファイル(App.config)の扱い方とは?ファイルの追加・設定値の読み込み・1キーに複数値の設定・設定値の変更方法

エンジニア
マネージャー
C#での設定ファイル(App.config)の扱い方とは?
今回は、C#での設定ファイル(App.config)の扱い方について説明します。設定ファイルは「アプリケーション構成ファイル」のことです。アプリケーション固有の設定情報を格納しているファイルです。
ここでは、設定ファイルの追加、設定値の読み込み、1キーに複数値の設定、設定値の変更方法について紹介します。
C#での設定ファイルの扱い方に興味のある方はぜひご覧ください。
App.configの追加
C#での設定ファイル(App.config)の追加方法を紹介します。
Visual Studioのソリューションエクスプローラで、プロジェクトを右クリックします。ポップアップメニューの「追加」→「新しい項目の追加」を選び「新しい項目の追加」ダイアログが表示されます。
「アプリケーション構成ファイル」を選択して「追加」ボタンをクリックすると「アプリケーション構成ファイル(App.config)」が作成されます。初期状態では以下のようになっています。
1 2 3 |
<?xml version="1.0" encoding="utf-8" ?> <configuration> </configuration> |
以下のように、設定ファイルに設定値を追加します。
1 2 3 4 5 6 7 8 |
<?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="key1" value="value1" /> <add key="key2" value="value2" /> <add key="key3" value="value3" /> </appSettings> </configuration> |
設定値の読み込み
C#での設定ファイルの読み込み方法を紹介します。プログラムに「using System.Configuration;」を記述します。
次に、Visual Studioのツール(T)→ NuGetパッケージマネージャー(N)→ ソリューションのNuGetパッケージの管理(N)と選択します。ソリューションのパッケージの管理ウィンドウが開きますので、検索ボックスに「ConfigurationManager」を入力します。
「System.Configuration.ConfigurationManager」を選択してOKボタンをクリックします。
設定ファイルの読み込みのためのソースコードを見てみましょう。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
using System; using System.Configuration; static class Sample { static void Main(string[] args) { // 指定したkeyの値を取得 Console.WriteLine("key: {0}, value: {1}", "key1", ConfigurationManager.AppSettings["key1"]); // 見つからない場合はnull Console.WriteLine("key: {0}, value: {1}", "keyX", ConfigurationManager.AppSettings["keyX"]); // 全てのkeyとvalueを取得 foreach (string key in ConfigurationManager.AppSettings.AllKeys) { Console.WriteLine("key: {0}, value: {1}", key, ConfigurationManager.AppSettings[key]); } } } |
実行結果は以下のようになります。
1 2 3 4 5 |
key: key1, value: value1 key: keyX, value: key: key1, value: value1 key: key2, value: value2 key: key3, value: value3 |
このようにC#では、設定ファイルの値を読み込めます。
1キーに複数値設定
C#での設定ファイルの1つのキーに複数値を設定する方法を紹介します。設定ファイルは以下の状態とします。
1 2 3 4 5 6 7 8 |
<?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="key1" value="value1" /> <add key="key1" value="value2" /> <add key="key1" value="value3" /> </appSettings> </configuration> |
それでは、実際のソースコードを見てみましょう。
1 2 3 4 5 6 7 8 9 10 11 |
using System; using System.Configuration; static class Sample { static void Main(string[] args) { // 指定したkeyの値を取得 Console.WriteLine("key: {0}, value: {1}", "key1", ConfigurationManager.AppSettings["key1"]); } } |
実行結果は以下のようになります。最後の値のみが取得されています。
1 |
key: key1, value: value3 |
1つのキーに複数値を設定するには、例えば以下のようにカンマ区切りにします。
1 2 3 4 5 6 |
<?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="key1" value="value1,value2,value3" /> </appSettings> </configuration> |
ソースコードは以下のようにします。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
using System; using System.Configuration; static class Sample { static void Main(string[] args) { // 全てのkeyとvalueを取得 foreach (string key in ConfigurationManager.AppSettings.AllKeys) { // カンマ区切りで分割 var values = ConfigurationManager.AppSettings[key].Split(','); foreach (string value in values) { Console.WriteLine("key: {0}, value: {1}", key, value); } } } } |
実行結果は以下のようになります。
1 2 3 |
key: key1, value: value1 key: key1, value: value2 key: key1, value: value3 |
このようにC#では、設定ファイルの1つのキーに複数値を設定できます。
設定値の変更
C#での設定ファイルの値変更方法を紹介します。設定ファイルは以下の状態とします。
1 2 3 4 5 6 7 8 |
<?xml version="1.0" encoding="utf-8" ?> <configuration> <appSettings> <add key="key1" value="value1" /> <add key="key2" value="value2" /> <add key="key3" value="value3" /> </appSettings> </configuration> |
ソースコードは以下のように記述します。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
using System; using System.Configuration; static class Sample { static void Main(string[] args) { Configuration config = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None); config.AppSettings.Settings["key2"].Value = "value22"; config.Save(); Console.WriteLine(config.FilePath); // 全てのkeyとvalueを取得 foreach (string key in ConfigurationManager.AppSettings.AllKeys) { Console.WriteLine("key: {0}, value: {1}", key, ConfigurationManager.AppSettings[key]); } } } |
実行結果は以下のようになります。
1 2 3 4 |
C:\Users\<ユーザ名>\source\repos\ConsoleApp1\ConsoleApp1\bin\Debug\netcoreapp3.1\ConsoleApp1.dll.config key: key1, value: value1 key: key2, value: value22 key: key3, value: value3 |
config.FilePathのファイルを開くと、設定値が変更されていることが分かります。
エンジニア
マネージャー
まとめ
いかがでしたでしょうか。C#での設定ファイル(App.config)の扱い方について説明しました。ここでは、設定ファイルの追加、設定値の読み込み、1キーに複数値の設定、設定値の変更方法について紹介しました。
ぜひご自身でC#のソースコードを書いて、理解を深めてください。
FEnet.NETナビ・.NETコラムは株式会社オープンアップシステムが運営しています。
株式会社オープンアップシステムはこんな会社です
秋葉原オフィスには株式会社オープンアップシステムをはじめグループのIT企業が集結!
数多くのエンジニアが集まります。

-
スマホアプリから業務系システムまで
スマホアプリから業務系システムまで開発案件多数。システムエンジニア・プログラマーとしての多彩なキャリアパスがあります。
-
充実した研修制度
毎年、IT技術のトレンドや社員の要望に合わせて、カリキュラムを刷新し展開しています。社内講師の丁寧なサポートを受けながら、自分のペースで学ぶことができます。
-
資格取得を応援
スキルアップしたい社員を応援するために資格取得一時金制度を設けています。受験料(実費)と合わせて資格レベルに合わせた最大10万円の一時金も支給しています。
-
東証プライム上場企業グループ
オープンアップシステムは東証プライム上場「株式会社オープンアップグループ」のグループ企業です。
安定した経営基盤とグループ間のスムーズな連携でコロナ禍でも安定した雇用を実現させています。
株式会社オープンアップシステムに興味を持った方へ
株式会社オープンアップシステムでは、開発系エンジニア・プログラマを募集しています。
年収をアップしたい!スキルアップしたい!大手の上流案件にチャレンジしたい!
まずは話だけでも聞いてみたい場合もOK。お気軽にご登録ください。


C#新着案件New Job
システム開発/東京都新宿区/【WEB面談可/C#経験者/20代前半の方活躍中/経験1年以上の方活躍中】/在宅勤務
月給29万~34万円東京都新宿区(新宿駅)システム開発/東京都新宿区/【WEB面談可/C#経験者/20代後半~40代の方活躍中/経験年数不問】/在宅勤務
月給41万~50万円東京都新宿区(新宿駅)デバック、テスト項目の作成/神奈川県横浜市/【WEB面談可/C#経験者/20代前半の方活躍中/経験1年以上の方活躍中】/在宅勤務
月給29万~34万円神奈川県横浜市(桜木町駅)デバック、テスト項目の作成/神奈川県横浜市/【WEB面談可/C#経験者/20代後半~40代の方活躍中/経験年数不問】/在宅勤務
月給41万~50万円神奈川県横浜市(桜木町駅)基幹システム開発導入/東京都新宿区/【WEB面談可/C#経験者/20代前半の方活躍中/経験1年以上の方活躍中】/在宅勤務
月給29万~34万円東京都新宿区(西新宿駅)基幹システム開発導入/東京都新宿区/【WEB面談可/C#経験者/20代後半~40代の方活躍中/経験年数不問】/在宅勤務
月給41万~50万円東京都新宿区(西新宿駅)