C#での設定ファイル（App.config）の扱い方とは？ファイルの追加・設定値の読み込み・1キーに複数値の設定・設定値の変更方法
- システム
エンジニア - C#での設定ファイルの扱い方について教えてください。
- プロジェクト
マネージャー - アプリケーション構成ファイルについて詳しく説明しましょう。
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＃での設定ファイルの扱い方がよくわかりました。
- プロジェクト
マネージャー - 設定ファイルの追加、設定値の読み込み、1キーに複数値の設定、設定値の変更方法について説明しました。自身でもソースコードを書いてみましょう。
まとめ
いかがでしたでしょうか。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万円東京都新宿区(西新宿駅)
関連記事Related Posts
-
VB.NETのForEach文とは？実践で使うための裏技も解説！
「VB.NETのFor Each文って、何に使うのかな……」 「VB.NETのFor Each文の具体的な使い方や、サンプルコードを知りたい……」 と思っていませんか？ For Each文は、ループ処理を作る時に覚えてお […]
-
WPFでComboBoxを実装する方法【書き方を解説】
ComboBoxは、あらかじめ設定された項目のリストからユーザーに選択してもらうようにするためのコントロールです。ユーザー情報を入力してもらう場合などで、テキストボックスと並んで頻繁に利用することになるので、入力フォーム […]
-
Visual StudioでNunitを使って単体テストを作成する方法
プログラムの動作チェックをする場合に、最初に行う単体テスト。C#には単体テストを行う際に、テストがしやすいようにNunitというツールがあり、これを使うことで通常では実施しにくい状況を発生させることが可能です。 単体テス […]
-
ASP.NET MVC 5を使ってコントローラーからデータにアクセスする
ASP.NET MVCの構成の特徴は、モデル、ビュー、コントローラーがそれぞれ切り分けられていることです。その中で、モデルのデータへのアクセスはコントローラーの役割となります。この記事では基本的な処理方法について触れてい […]
-
C#のTimeSpan構造体で時間の情報を操作する方法
C#では、「TimeSpan構造体」を使って時間の情報を操作することができます。今回は、TimeSpan構造の概要から実際の使い方までを紹介していきたいと思います。ぜひ、参考にしていただければ幸いです。 TimeSpan […]
