C#.NET 读写 INI配置文件

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

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

[Section1] 　　KeyWord1 = Valuel 　　KeyWord2 = Value2 　　　…… 　　[Section2] 　　KeyWord3 = Value3 　　KeyWord4 = Value4

本文中介绍的程序设计及运行环境：

● 微软视窗2000 高级服务器版

● .Net Framework SDK正式版

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文件的完整路径和名称。

using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using System.Runtime.InteropServices;
using System.IO;

namespace INIFileTest
{
    public partial class Form1 : Form
    {
        [DllImport(“kernel32”)]
        private static extern long WritePrivateProfileString(string section, string key,
                                                             string val, string filePath);
        /*参数说明：section：INI文件中的段落；key：INI文件中的关键字；
          val：INI文件中关键字的数值；filePath：INI文件的完整的路径和名称。*/
        [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文件的完整路径和名称。*/

        string FileName = @”..\..\test.ini”;

        public Form1()
        {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            /*对INI文件进行写操作的时候，如果此时在INI文件中存在和
              要写入的信息相同的段落名称和关键字，则将覆盖此INI信息。*/
            WritePrivateProfileString(“段落名称一”, “键一”, “值一”, FileName);
            WritePrivateProfileString(“段落名称二”, “键二”, “值二”, FileName);
            WritePrivateProfileString(“段落名称三”, “键三”, “值三”, FileName);
            MessageBox.Show(“成功写入INI文件！”, “信息”);
        }

        private void button2_Click(object sender, EventArgs e)
        {
            /*正确读取INI的必须满足三个前提：INI文件的全路径、段落名称和关键字名称。
              否则就无法正确读取。你可以设定读取不成功后的缺省数值，
              在下面的程序中，为了直观设定的是“无法读取对应数值！”字符串。*/
            StringBuilder temp = new StringBuilder(255);
            int i = GetPrivateProfileString(“段落名称一”, “键一”, “无法读取对应数值！”,
                                             temp, 255, FileName);
            int jj = temp.Length;
            MessageBox.Show(“键一=” + temp.ToString());
        }

        private void button3_Click(object sender, EventArgs e)
        {
            //删除一个键值
            WritePrivateProfileString(“段落名称一”, “键一”, null, FileName);
            //删除一个段落
            WritePrivateProfileString(“段落名称一”, null, null, FileName);
        }
    }
}