雖然現代 .NET 應用多使用 web.config、appsettings.json 或資料庫儲存設定,但在以下情境 INI 檔案仍具優勢:
透過 P/Invoke 呼叫 Windows API kernel32.dll 中的 WritePrivateProfileString 與 GetPrivateProfileString 實作讀寫:
using System;
using System.Runtime.InteropServices;
using System.Text;
namespace CreateWebDir
{
public class INIFile
{
public string Path { get; private set; }
public INIFile(string iniPath)
{
Path = iniPath;
}
// 寫入值
[DllImport("kernel32", CharSet = CharSet.Auto)]
private static extern long WritePrivateProfileString(
string section, string key, string val, string filePath);
// 讀取值
[DllImport("kernel32", CharSet = CharSet.Auto)]
private static extern int GetPrivateProfileString(
string section, string key, string def,
StringBuilder retVal, int size, string filePath);
public void IniWriteValue(string section, string key, string value)
{
WritePrivateProfileString(section, key, value, this.Path);
}
public string IniReadValue(string section, string key)
{
var temp = new StringBuilder(255);
int i = GetPrivateProfileString(section, key, "", temp, 255, this.Path);
return temp.ToString();
}
}
}
CharSet = CharSet.Auto:自動依執行平台選擇 ANSI/Unicode 版本 API,提升相容性CharSet.Unicode 並對應 WritePrivateProfileStringWnew StringBuilder(255) 設定緩衝區大小,對應 API 的 nSize 參數。若值可能超過 255 字元,需加大緩衝區。
建構子接收完整路徑,建議使用 Server.MapPath 或 Path.Combine 組合路徑,避免相對路徑問題。
protected void Page_Load(object sender, EventArgs e)
{
string iniFile = @"F:\test\test.ini";
// 確保檔案存在
if (!File.Exists(iniFile))
{
using (FileStream fs = File.Create(iniFile)) { }
}
var myINI = new CreateWebDir.INIFile(iniFile);
for (int i = 0; i < 10; i++)
{
string value = Convert.ToString(i + i * i * i);
myINI.IniWriteValue("WebDir", "arg" + i, value);
}
}
protected void Page_Load(object sender, EventArgs e)
{
var myINI = new CreateWebDir.INIFile(@"F:\test\test.ini");
string value = myINI.IniReadValue("WebDir", "arg5");
Response.Write(value); // 輸出: 130 (5 + 5^3 = 5 + 125)
}
執行上述寫入後,test.ini 內容如下:
[WebDir]
arg0=0
arg1=2
arg2=10
arg3=30
arg4=68
arg5=130
arg6=222
arg7=350
arg8=520
arg9=738
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| INI (Kernel32 API) | 輕量、與原生應用相容、無依賴 | 功能簡單、無型別支援、平台相依 | 舊系統整合、極簡部署 |
| web.config / app.config | .NET 原生支援、型別安全、區段管理 | XML 結構較繁瑣、需重啟應用才生效部分變更 | 標準 ASP.NET 應用設定 |
| appsettings.json | 結構化、支援巢狀、熱重載、跨平台 | 需額外套件 (Microsoft.Extensions.Configuration) | .NET Core / .NET 5+ 現代應用 |
| 資料庫儲存 | 集中管理、動態更新、多實例共享 | 需資料庫連線、較重 | 分散式系統、動態設定管理 |
\\?\ 前綴本文完整展示了在 ASP.NET 中透過 P/Invoke 封裝 Windows API 實現 INI 檔案讀寫的做法。雖然屬於較傳統技術,但在特定整合場景下仍具不可替代性。現代專案建議優先考慮 appsettings.json 或配置中心方案,僅在必要時使用 INI 互通機制。