C# ini ファイルに値を書き込む

このサイトはプロモーションを含みます

2024年9月14日

アプリケーションの設定を管理する際、iniファイルは簡単で読みやすい形式として長年使われてきました。C#でプログラムを開発する中で、iniファイルに新しい設定値を書き込んだり、既存の値を更新したりする必要がしばしば発生します。この記事では、C#を使ってiniファイルに値を書き込む方法を、初心者にも分かりやすく解説します。

ini ファイルの基本構造

まず、典型的なiniファイルの構造を確認しておきましょう：

[AppSettings]
Language=Japanese
Theme=Dark

[UserPreferences]
AutoSave=true
FontSize=12

iniファイルは、[セクション名]で始まるセクションと、その下にキー=値の形式で書かれる設定項目で構成されています。

C#で ini ファイルに書き込む

C#には、iniファイルを直接扱うための組み込み関数がないため、自前で実装する必要があります。以下に、iniファイルに値を書き込むための基本的なコード例を示します：

using System;
using System.IO;
using System.Text;

public class IniFileWriter
{
    private string filePath;

    public IniFileWriter(string path)
    {
        filePath = path;
    }

    public void WriteValue(string section, string key, string value)
    {
        var content = new StringBuilder();
        bool sectionFound = false;
        bool keyUpdated = false;

        // ファイルが存在する場合、内容を読み込む
        if (File.Exists(filePath))
        {
            string[] lines = File.ReadAllLines(filePath);
            string currentSection = "";

            foreach (string line in lines)
            {
                string trimmedLine = line.Trim();
                if (trimmedLine.StartsWith("[") && trimmedLine.EndsWith("]"))
                {
                    // 新しいセクションの開始
                    currentSection = trimmedLine.Substring(1, trimmedLine.Length - 2);
                    content.AppendLine(line);

                    if (currentSection.Equals(section, StringComparison.OrdinalIgnoreCase))
                    {
                        sectionFound = true;
                    }
                }
                else if (sectionFound && !keyUpdated)
                {
                    // セクション内でキーを探す
                    int equalPos = trimmedLine.IndexOf('=');
                    if (equalPos > 0)
                    {
                        string currentKey = trimmedLine.Substring(0, equalPos).Trim();
                        if (currentKey.Equals(key, StringComparison.OrdinalIgnoreCase))
                        {
                            // キーが見つかったら値を更新
                            content.AppendLine($"{key}={value}");
                            keyUpdated = true;
                            continue;
                        }
                    }
                }
                content.AppendLine(line);
            }
        }

        // セクションが見つからなかった場合、新しく追加
        if (!sectionFound)
        {
            content.AppendLine($"[{section}]");
            content.AppendLine($"{key}={value}");
        }
        // セクションは存在するがキーが見つからなかった場合、セクションの最後に追加
        else if (!keyUpdated)
        {
            content.AppendLine($"{key}={value}");
        }

        // ファイルに書き込む
        File.WriteAllText(filePath, content.ToString());
    }
}

このコードの主なポイントは以下の通りです：

既存のファイル内容を読み込み、セクションとキーを探します。
セクションが見つかった場合、そのセクション内でキーを探し、値を更新します。
セクションが見つからない場合、新しくセクションとキー・値のペアを追加します。
セクションは存在するがキーが見つからない場合、セクションの最後にキー・値のペアを追加します。
最後に、更新された内容を元のファイルに書き込みます。

使用例

このクラスを使用して、iniファイルに値を書き込む例を示します：

class Program
{
    static void Main()
    {
        string iniFilePath = @"C:\path\to\your\settings.ini";
        IniFileWriter writer = new IniFileWriter(iniFilePath);

        // 既存のセクションに新しい値を書き込む
        writer.WriteValue("AppSettings", "Language", "English");

        // 新しいセクションと値を追加
        writer.WriteValue("NewSection", "NewKey", "NewValue");

        Console.WriteLine("iniファイルが更新されました。");
    }
}