萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 操作 INI 設定檔讀寫完整實作與 P/Invoke 解析

為什麼還需要 INI 檔案?

雖然現代 .NET 應用多使用 web.config、appsettings.json 或資料庫儲存設定,但在以下情境 INI 檔案仍具優勢:

  • 與傳統 Win32/C++ 應用程式共用設定
  • 簡單的部署環境,不想引入 XML/JSON 解析依賴
  • 需要直接編輯純文字設定檔的輕量級案例

核心封裝類別:INIFile

透過 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();
        }
    }
}

關鍵技術細節解析

1. DllImport 與 CharSet 設定

  • CharSet = CharSet.Auto:自動依執行平台選擇 ANSI/Unicode 版本 API,提升相容性
  • 若明確指定 Unicode,可用 CharSet.Unicode 並對應 WritePrivateProfileStringW

2. StringBuilder 緩衝區大小

new StringBuilder(255) 設定緩衝區大小,對應 API 的 nSize 參數。若值可能超過 255 字元,需加大緩衝區。

3. 檔案路徑處理

建構子接收完整路徑,建議使用 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)
}

INI 檔案結構範例

執行上述寫入後,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+ 現代應用
資料庫儲存集中管理、動態更新、多實例共享需資料庫連線、較重分散式系統、動態設定管理

注意事項與最佳實踐

  1. 權限問題:ASP.NET 執行身分需有目標目錄寫入權限
  2. 並發存取:INI API 非執行緒安全,高併發下需自行加鎖
  3. 編碼一致性:確保寫入與讀取使用相同編碼(API 通常使用系統預設編碼)
  4. 路徑長度限制:Windows 路徑限制 260 字元,長路徑需加 \\?\ 前綴
  5. 安全性:避免在 INI 儲存敏感資訊(連線字串、密鑰),應使用加密或安全存儲

總結

本文完整展示了在 ASP.NET 中透過 P/Invoke 封裝 Windows API 實現 INI 檔案讀寫的做法。雖然屬於較傳統技術,但在特定整合場景下仍具不可替代性。現代專案建議優先考慮 appsettings.json 或配置中心方案,僅在必要時使用 INI 互通機制。

copyright © 萬盛學電腦網 all rights reserved