如何在C＃中读写INI文档

INI文档就是扩展名为“ini”的文档。在Windows系统中，INI文档是很多，最重要的就是“System.ini”、“System32.ini”和“Win.ini”。该文档主要存放用户所做的选择连同系统的各种参数。用户能够通过修改INI文档，来改变应用程式和系统的很多配置。但自从Windows95的退出，在Windows系统中引入了注册表的概念，INI文档在Windows系统的地位就开始不断下滑，这是因为注册表的独特长处，使应用程式和系统都把许多参数和初始化信息放进了注册表中。但在某些场合，INI文档还拥有其不可替代的地位。本文就来探讨一下C＃是如何对INI进行读写操作。

INI文档的结构

　　　INI文档是一种按照特点方式排列的文本文档。每一个INI文档构成都很类似，由若干段落（section）组成，在每个带括号的标题下面，是若干个以单个单词开头的关键词（keyword）和一个等号，等号右边的就是关键字对应的值（value）。其一般形式如下：

　　[Section1]

　　KeyWord1=Valuel

　　KeyWord2=Value2

　　……

　　[Section2]

　　KeyWord3=Value3

　　　KeyWord4=Value4

　　C＃和Win32API函数

　　C＃并不像C＋＋，拥有属于自己的类库。C＃使用的类库是.Net框架为任何.Net程式研发提供的一个共有的类库——.NetFrameWorkSDK。虽然.NetFrameWorkSDK内容十分庞大，功能也很强大，但还不能面面俱到，至少他并没有提供直接操作INI文档所需要的相关的类。在本文中，C＃操作INI文档使用的是Windows系统自带Win32的API函数——WritePrivateProfileString（）和GetPrivateProfileString（）函数。这二个函数都位于“kernel32.dll”文档中。

　　我们知道在C＃中使用的类库都是托管代码（ManagedCode）文档，而Win32的API函数所处的文档，都是非托管代码（UnmanagedCode）文档。这就导致了在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")]

　　privatestaticexternlongWritePrivateProfileString(string

　　section,

　　stringkey,stringval,stringfilePath);

　　参数说明：section：INI文档中的段落；key：INI文档中的关键字；val：INI文档中关键字的数值；filePath：INI文档的完整的路径和名称。

　　C＃申明INI文档的读操作函数GetPrivateProfileString（）：

　　[DllImport("kernel32")]

　　privatestaticexternintGetPrivateProfileString(stringsection,

　　stringkey,stringdef,StringBuilderretVal,

intsize,stringfilePath);

参数说明：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);

　　　}

　　　}