如何在C＃中讀寫INI文件

  INI文件就是擴展名爲“ini”的文件。在Windows系統中，INI文件是很多，最重要的就是“System.ini”、“System32.ini”和“Win.ini”。該文件主要存放用戶所做的選擇以及系統的各種參數。用戶可以通過修改INI文件，來改變應用程序和系統的很多配置。但自從Windows 95的退出，在Windows系統中引入了註冊表的概念，INI文件在Windows系統的地位就開始不斷下滑，這是因爲註冊表的獨特優點，使應用程序和系統都把許多參數和初始化信息放進了註冊表中。但在某些場合，INI文件還擁有其不可替代的地位。本文就來探討一下C＃是如何對INI進行讀寫操作。

  INI文件的結構
   INI文件是一種按照特點方式排列的文本文件。每一個INI文件構成都非常類似，由若干段落（section）組成，在每個帶括號的標題下面，是若干個以單個單詞開頭的關鍵詞（keyword）和一個等號，等號右邊的就是關鍵字對應的值（value）。其一般形式如下：
  [Section1]
　　KeyWord1 = Valuel
　　KeyWord2 = Value2
　　　……
　　[Section2]
　　KeyWord3 = Value3
　　KeyWord4 = Value4

      C＃和Win32 API函數

       C＃並不像C＋＋，擁有屬於自己的類庫。C＃使用的類庫是.Net框架爲所有.Net程序開發提供的一個共有的類庫——.Net FrameWork SDK。雖然.Net FrameWork SDK內容十分龐大，功能也非常強大，但還不能面面俱到，至少它並沒有提供直接操作INI文件所需要的相關的類。在本文中，C＃操作INI文件使用的是Windows系統自帶Win32的API函數——WritePrivateProfileString（）和GetPrivateProfileString（）函數。這二個函數都位於“kernel32.dll”文件中。

  我們知道在C＃中使用的類庫都是託管代碼（Managed Code）文件，而Win32的API函數所處的文件，都是非託管代碼（Unmanaged Code）文件。這就導致了在C＃中不可能直接使用這些非託管代碼文件中的函數。好在.Net框架爲了保持對下的兼容，也爲了充分利用以前的資源，提出了互操作，通過互操作可以實現對Win32的API函數的調用。互操作不僅適用於Win32的API函數，還可以用來訪問託管的COM對象。C＃中對Win32的API函數的互操作是通過命名空間“System.Runtime.InteropServices”中的“DllImport”特徵類來實現的。它的主要作用是指示此屬性化方法是作爲非託管DLL的輸出實現的。下面代碼就是在C＃利用命名空間“System.Runtime.InteropServices”中的“DllImport”特徵類申明上面二個Win32的API函數：

  C＃申明INI文件的寫操作函數WritePrivateProfileString（）：

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

  參數說明：section：INI文件中的段落；key：INI文件中的關鍵字；val：INI文件中關鍵字的數值；filePath：INI文件的完整的路徑和名稱。

  C＃申明INI文件的讀操作函數GetPrivateProfileString（）：

  [ DllImport ( "kernel32" ) ]
  private static extern int GetPrivateProfileString ( string section ,
   string key , string def , StringBuilder retVal ,
   int size , string filePath ) ;

  參數說明：section：INI文件中的段落名稱；key：INI文件中的關鍵字；def：無法讀取時候時候的缺省數值；retVal：讀取數值；size：數值的大小；filePath：INI文件的完整路徑和名稱。
 
  下面是一個讀寫INI文件的類
   public class INIClass
   {
    public string inipath;
    [DllImport("kernel32")]
    private static extern long WritePrivateProfileString(string section,string key,string val,string filePath);
    [DllImport("kernel32")]
    private static extern int GetPrivateProfileString(string section,string key,string def,StringBuilder retVal,int size,string filePath);
    /// <summary>
    /// 構造方法
    /// </summary>
    /// <param name="INIPath">文件路徑</param>
    public INIClass(string INIPath)
    {
     inipath = INIPath;
    }
    /// <summary>
    /// 寫入INI文件
    /// </summary>
    /// <param name="Section">項目名稱(如 [TypeName] )</param>
    /// <param name="Key">鍵</param>
    /// <param name="Value">值</param>
    public void IniWriteValue(string Section,string Key,string Value)
    {
     WritePrivateProfileString(Section,Key,Value,this.inipath);
    }
    /// <summary>
    /// 讀出INI文件
    /// </summary>
    /// <param name="Section">項目名稱(如 [TypeName] )</param>
    /// <param name="Key">鍵</param>
    public string IniReadValue(string Section,string Key)
    {
     StringBuilder temp = new StringBuilder(500);
     int i = GetPrivateProfileString(Section,Key,"",temp,500,this.inipath);
     return temp.ToString();
    }
    /// <summary>
    /// 驗證文件是否存在
    /// </summary>
    /// <returns>布爾值</returns>
    public bool ExistINIFile()
    {
     return File.Exists(inipath);
    }
   }