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

C#
プログラミング言語

公開日時: 2021-07-28 　更新日時: 2022-06-01

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

この記事でわかること

システム エンジニア: C#での設定ファイルの扱い方について教えてください。

プロジェクト マネージャー: アプリケーション構成ファイルについて詳しく説明しましょう。

C#での設定ファイル（App.config）の扱い方とは？

今回は、C#での設定ファイル（App.config）の扱い方について説明します。設定ファイルは「アプリケーション構成ファイル」のことです。アプリケーション固有の設定情報を格納しているファイルです。

ここでは、設定ファイルの追加、設定値の読み込み、1キーに複数値の設定、設定値の変更方法について紹介します。

C#での設定ファイルの扱い方に興味のある方はぜひご覧ください。

App.configの追加

C#での設定ファイル（App.config）の追加方法を紹介します。

Visual Studioのソリューションエクスプローラで、プロジェクトを右クリックします。ポップアップメニューの「追加」→「新しい項目の追加」を選び「新しい項目の追加」ダイアログが表示されます。

「アプリケーション構成ファイル」を選択して「追加」ボタンをクリックすると「アプリケーション構成ファイル（App.config）」が作成されます。初期状態では以下のようになっています。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
</configuration>

<?xml version="1.0" encoding="utf-8" ?>

</configuration>

以下のように、設定ファイルに設定値を追加します。

<?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>

<?xml version="1.0" encoding="utf-8" ?>

</appSettings>

</configuration>

設定値の読み込み

C#での設定ファイルの読み込み方法を紹介します。プログラムに「using System.Configuration;」を記述します。

次に、Visual Studioのツール（T）→ NuGetパッケージマネージャー（N）→ ソリューションのNuGetパッケージの管理（N）と選択します。ソリューションのパッケージの管理ウィンドウが開きますので、検索ボックスに「ConfigurationManager」を入力します。
「System.Configuration.ConfigurationManager」を選択してOKボタンをクリックします。

設定ファイルの読み込みのためのソースコードを見てみましょう。

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]);
        }
    }
}

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]);

}

実行結果は以下のようになります。

key: key1, value: value1
key: keyX, value:
key: key1, value: value1
key: key2, value: value2
key: key3, value: value3

key: key1, value: value1

key: keyX, value:

key: key1, value: value1

key: key2, value: value2

key: key3, value: value3

このようにC#では、設定ファイルの値を読み込めます。

1キーに複数値設定

C#での設定ファイルの1つのキーに複数値を設定する方法を紹介します。設定ファイルは以下の状態とします。

<?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>

<?xml version="1.0" encoding="utf-8" ?>

</appSettings>

</configuration>

それでは、実際のソースコードを見てみましょう。

using System;
using System.Configuration;

static class Sample
{
    static void Main(string[] args)
    {
        // 指定したkeyの値を取得
        Console.WriteLine("key: {0}, value: {1}", "key1", ConfigurationManager.AppSettings["key1"]);
    }
}

using System;

using System.Configuration;

static class Sample

{

static void Main(string[] args)

{

// 指定したkeyの値を取得

Console.WriteLine("key: {0}, value: {1}", "key1", ConfigurationManager.AppSettings["key1"]);

}

実行結果は以下のようになります。最後の値のみが取得されています。

key: key1, value: value3

1	key: key1, value: value3

1つのキーに複数値を設定するには、例えば以下のようにカンマ区切りにします。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <appSettings>
        <add key="key1" value="value1,value2,value3" />
    </appSettings>
</configuration>

<?xml version="1.0" encoding="utf-8" ?>

</appSettings>

</configuration>

ソースコードは以下のようにします。

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);
            }
        }
    }
}

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);

}

実行結果は以下のようになります。

key: key1, value: value1
key: key1, value: value2
key: key1, value: value3

key: key1, value: value1

key: key1, value: value2

key: key1, value: value3

このようにC#では、設定ファイルの1つのキーに複数値を設定できます。

設定値の変更

C#での設定ファイルの値変更方法を紹介します。設定ファイルは以下の状態とします。

<?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>

<?xml version="1.0" encoding="utf-8" ?>

</appSettings>

</configuration>

ソースコードは以下のように記述します。

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]);
        }
    }
}

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]);

}

実行結果は以下のようになります。

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

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。お気軽にご登録ください。

株式会社オープンアップシステムへ応募する
会員登録不要! カンタン45秒!

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

C#での設定ファイル（App.config）の扱い方とは？

App.configの追加

設定値の読み込み

1キーに複数値設定

設定値の変更

まとめ

株式会社オープンアップシステムはこんな会社です

スマホアプリから業務系システムまで

充実した研修制度

資格取得を応援

東証プライム上場企業グループ

株式会社オープンアップシステムに興味を持った方へ

C＃新着案件New Job

システム開発/東京都新宿区/【WEB面談可/C#経験者/20代前半の方活躍中/経験1年以上の方活躍中】/在宅勤務

システム開発/東京都新宿区/【WEB面談可/C#経験者/20代後半～40代の方活躍中/経験年数不問】/在宅勤務

デバック、テスト項目の作成/神奈川県横浜市/【WEB面談可/C#経験者/20代前半の方活躍中/経験1年以上の方活躍中】/在宅勤務

デバック、テスト項目の作成/神奈川県横浜市/【WEB面談可/C#経験者/20代後半～40代の方活躍中/経験年数不問】/在宅勤務

基幹システム開発導入/東京都新宿区/【WEB面談可/C#経験者/20代前半の方活躍中/経験1年以上の方活躍中】/在宅勤務

基幹システム開発導入/東京都新宿区/【WEB面談可/C#経験者/20代後半～40代の方活躍中/経験年数不問】/在宅勤務

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

C#での設定ファイル（App.config）の扱い方とは？

App.configの追加

設定値の読み込み

1キーに複数値設定

設定値の変更

まとめ

株式会社オープンアップシステムはこんな会社です

スマホアプリから業務系システムまで

充実した研修制度

資格取得を応援

東証プライム上場企業グループ

株式会社オープンアップシステムに興味を持った方へ

C＃新着案件New Job

システム開発/東京都新宿区/【WEB面談可/C#経験者/20代前半の方活躍中/経験1年以上の方活躍中】/在宅勤務

システム開発/東京都新宿区/【WEB面談可/C#経験者/20代後半～40代の方活躍中/経験年数不問】/在宅勤務

デバック、テスト項目の作成/神奈川県横浜市/【WEB面談可/C#経験者/20代前半の方活躍中/経験1年以上の方活躍中】/在宅勤務

デバック、テスト項目の作成/神奈川県横浜市/【WEB面談可/C#経験者/20代後半～40代の方活躍中/経験年数不問】/在宅勤務

基幹システム開発導入/東京都新宿区/【WEB面談可/C#経験者/20代前半の方活躍中/経験1年以上の方活躍中】/在宅勤務

基幹システム開発導入/東京都新宿区/【WEB面談可/C#経験者/20代後半～40代の方活躍中/経験年数不問】/在宅勤務

関連記事Related Posts

VB.NETのForEach文とは？実践で使うための裏技も解説！

WPFでComboBoxを実装する方法【書き方を解説】

Visual StudioでNunitを使って単体テストを作成する方法

ASP.NET MVC 5を使ってコントローラーからデータにアクセスする

C#のTimeSpan構造体で時間の情報を操作する方法