C# 讀寫 INI 文件的最簡方法，你學會了嗎？

作者：conan 2025-01-09 07:58:42

使用Windows API函數是C#中讀寫INI文件的一種簡單而有效的方法。它不需要額外的庫或復雜的代碼，適用于簡單的配置管理需求。然而，在處理復雜的配置數據或需要跨平臺支持的情況下，可能需要考慮其他配置文件格式和讀寫方法。?

引言

INI文件是一種簡單的配置文件格式，廣泛用于存儲應用程序的配置信息。它具有易于閱讀和編輯的特點，通常由多個節（Section）和鍵值對（Key-Value Pair）組成。在C#中，讀寫INI文件可以通過多種方法實現，其中最簡單的方法之一是使用Windows API函數。

INI文件格式簡介

INI文件的格式如下：

[Section1]
Key1=Value1
Key2=Value2

[Section2]
Key3=Value3

每個節以方括號[]包圍的名稱開始，節內包含多個鍵值對，鍵和值之間用等號=分隔。

使用Windows API讀寫INI文件

C#可以通過調用Windows API函數GetPrivateProfileString和WritePrivateProfileString來讀取和寫入INI文件。這些函數位于kernel32.dll庫中，可以通過P/Invoke技術在C#中調用。

讀取INI文件

要讀取INI文件中的值，可以使用GetPrivateProfileString函數。以下是一個示例方法，用于讀取指定節和鍵的值：

using System;
using System.Runtime.InteropServices;

public class IniFile
{
    [DllImport("kernel32")]
    private static extern int GetPrivateProfileString(
        string section,
        string key,
        string defaultValue,
        StringBuilder retVal,
        int size,
        string filePath);

    public string ReadValue(string section, string key, string filePath)
    {
        StringBuilder buffer = new StringBuilder(255);
        GetPrivateProfileString(section, key, "", buffer, 255, filePath);
        return buffer.ToString();
    }
}

使用示例：

var iniFile = new IniFile();
string value = iniFile.ReadValue("Section1", "Key1", "path/to/config.ini");
Console.WriteLine(value); // 輸出讀取到的值

寫入INI文件

要寫入INI文件，可以使用WritePrivateProfileString函數。以下是一個示例方法，用于寫入指定節和鍵的值：

[DllImport("kernel32")]
private static extern bool WritePrivateProfileString(
    string section,
    string key,
    string value,
    string filePath);

public void WriteValue(string section, string key, string value, string filePath)
{
    WritePrivateProfileString(section, key, value, filePath);
}

使用示例：

iniFile.WriteValue("Section1", "Key1", "NewValue", "path/to/config.ini");

注意事項

文件路徑：確保INI文件的路徑正確，且應用程序有足夠的權限訪問該文件。
編碼：Windows API函數默認使用ANSI編碼讀寫INI文件，如果需要使用其他編碼，可能需要進行相應的轉換。
性能：對于頻繁讀寫INI文件的場景，建議緩存讀取的值，以減少文件I/O操作的次數。

結論

使用Windows API函數是C#中讀寫INI文件的一種簡單而有效的方法。它不需要額外的庫或復雜的代碼，適用于簡單的配置管理需求。然而，在處理復雜的配置數據或需要跨平臺支持的情況下，可能需要考慮其他配置文件格式和讀寫方法。

責任編輯：武曉燕來源：程序員編程日記

C#API 函數