91网首页-91网页版-91网在线观看-91网站免费观看-91网站永久视频-91网站在线播放

一、前言

INI文件，全稱為Initialization File（初始化文件），是一種傳統的文本型配置文件格式，廣泛應用于Windows操作系統及早期應用程序中，用于存儲軟件的各項設置和參數。

盡管開發中XML、JSON或更現代的配置格式如YAML等逐漸占據主流，但INI文件憑借其簡潔明了的結構和易于人類閱讀與編輯的特點，在特定場景下仍然具有不可替代的價值。

本文將聚焦于C#語言環境下，介紹如何以最簡化的方式實現INI文件的讀寫操作。

二、INI文件基礎

INI文件采用鍵值對（key-value pairs）的形式組織數據，并將其劃分為若干個邏輯段落（sections）。

其基本結構如下：

; 注釋行（以分號開始）

[Section1]     ; 段落名，用方括號包圍
key1 = value1   ; 鍵值對，等號分隔鍵與值
key2 = value2

[Section2]
keyA = valueA
keyB = valueB

其中：

注釋：以分號（;）開頭的行被視為注釋，用于解釋文件中的設置。

段落（Section）：用方括號（[]）包裹的名稱標識一個特定的配置區域，用于分類相關設置。

鍵（Key）：在每個段落內定義的唯一標識符，用于表示特定的配置項。

值（Value）：與鍵關聯的數據，可以是字符串、數字或其他簡單文本表示的信息。

三、C#讀寫INI文件的最簡方法

在C#中，雖然.NET框架并未直接提供對INI文件的內置支持，但可以通過以下兩種簡便途徑實現INI文件的讀寫：

1、使用Microsoft.VisualBasic命名空間提供的API

盡管名為Visual Basic，但此命名空間中的類庫在C#中同樣可用。

其中包含了對INI文件操作的便捷方法，無需額外引入外部庫或編寫復雜的P/Invoke代碼。

以下是最簡示例：

using Microsoft.VisualBasic.FileIO;

// 讀取INI文件
public string ReadIniValue(string section, string key, string filePath)
{
    return IniParser.ReadKeyValue(filePath, section, key, "");
}

// 寫入INI文件
public void WriteIniValue(string section, string key, string value, string filePath)
{
    IniParser.WriteKeyValue(filePath, section, key, value);
}

// 定義輔助類
internal static class IniParser
{
    [DllImport("kernel32")]
    private static extern int GetPrivateProfileString(string section, string key, string def, StringBuilder retVal, int size, string filePath);
    [DllImport("kernel32")]
    private static extern int WritePrivateProfileString(string section, string key, string val, string filePath);

    internal static string ReadKeyValue(string iniPath, string section, string key, string defaultValue)
    {
        const int MAX_BUFFER = 65535;
        var sb = new StringBuilder(MAX_BUFFER);
        GetPrivateProfileString(section, key, defaultValue, sb, MAX_BUFFER, iniPath);
        return sb.ToString();
    }

    internal static void WriteKeyValue(string iniPath, string section, string key, string value)
    {
        WritePrivateProfileString(section, key, value, iniPath);
    }
}

2、利用第三方庫

若希望避免直接調用Win32 API，或者尋求更豐富的功能和更好的錯誤處理，可以選用成熟的第三方庫，如IniFileParser或Nini等。

這些庫提供了面向對象的接口，簡化了INI文件的操作。

以下是一個使用IniFileParser庫的簡例：

using IniParser;
using IniParser.Model;

// 讀取INI文件
public string ReadIniValue(string section, string key, string filePath)
{
    var parser = new FileIniDataParser();
    IniData data = parser.ReadFile(filePath);
    return data[section][key];
}

// 寫入INI文件
public void WriteIniValue(string section, string key, string value, string filePath)
{
    var parser = new FileIniDataParser();
    IniData data = parser.ReadFile(filePath);
    data[section][key] = value;
    parser.WriteFile(filePath, data);
}

四、結語

盡管INI文件并非現代應用程序首選的配置格式，但在特定需求下，尤其是對于輕量級、跨平臺要求不高的項目，其簡潔性仍使其成為一個可行的選擇。

C#開發可通過使用Microsoft.VisualBasic命名空間提供的API或第三方庫，以最簡化的代碼實現INI文件的讀寫操作。

這兩種方法均能有效滿足基本的INI文件處理需求，可根據項目的具體需求和偏好選擇合適的方法。