首页 > 代码库 > 关于C#操作INI文件的总结

关于C#操作INI文件的总结

原文:关于C#操作INI文件的总结

 

       INI文件其实是一种具有特定结构的文本文件,它的构成分为三部分,结构如下:

[Section1]
key 
1 = value2
key 
1 = value2
……
[Section2]
key 
1 = value1
key 
2 = value2
……

文件由若干个段落(section)组成,每个段落又分成若干个key)和值(value)。Windows系统自带的Win32API函数GetPrivateProfileString()WritePrivateProfileString()分别实现了对INI文件的读写操作,他们位于kernel32.dll下。

但是令人遗憾的是C#所使用的.NET框架下的公共类库并没有提供直接操作INI文件的类,所以唯一比较理想的方法就是调用API函数。

然后,.Net框架下的类库是基于托管代码的,而API函数是基于非托管代码的,(在运行库的控制下执行的代码称作托管代码。相反,在运行库之外运行的代码称作非托管代码。)如何实现托管代码与非托管代码之间的操作呢?.Net框架的System.Runtime.InteropServices命名空间下提供各种各样支持COM interop及平台调用服务的成员,其中最重要的属性之一DllImportAttribute可以用来定义用于访问非托管API的平台调用方法,它提供了对从非托管DLL导出的函数进行调用所必需的信息。下面就来看一下如何实现C#API函数的互操作。

读操作:

技术分享[DllImport("kernel32")]
技术分享
private static extern int GetPrivateProfileString(string section, string key, string defVal, StringBuilder retVal, int size, string filePath); 
技术分享section:要读取的段落名
技术分享key: 要读取的键
技术分享defVal: 读取异常的情况下的缺省值
技术分享retVal: key所对应的值,如果该key不存在则返回空值
技术分享size: 值允许的大小
技术分享filePath: INI文件的完整路径和文件名

写操作:

技术分享[DllImport("kernel32")] 
技术分享
private static extern long WritePrivateProfileString(string section, string key, string val, string filePath); 
技术分享section: 要写入的段落名
技术分享key: 要写入的键,如果该key存在则覆盖写入
技术分享val: key所对应的值
技术分享filePath: INI文件的完整路径和文件名

       这样,在就可以使用对他们的调用,用常规的方式定义一个名为IniFile类:

 1技术分享using System;
 2技术分享using System.Runtime.InteropServices; 
 3技术分享using System.Text; 
 4技术分享
 5技术分享namespace IPVOD.Hotel.Remoting
 6技术分享{
 7技术分享    /// <summary>
 8技术分享    /// INI文件的操作类
 9技术分享    /// </summary>

10技术分享    public class IniFile
11技术分享    {
12技术分享        public string Path;
13技术分享
14技术分享        public IniFile(string path)
15技术分享        {
16技术分享            this.Path = path;
17技术分享        }

18技术分享        
19技术分享        声明读写INI文件的API函数
29技术分享
30技术分享        /// <summary>
31技术分享        /// 写INI文件
32技术分享        /// </summary>
33技术分享        /// <param name="section">段落</param>
34技术分享        /// <param name="key"></param>
35技术分享        /// <param name="iValue"></param>

36技术分享        public void IniWriteValue(string section, string key, string iValue) 
37技术分享        {
38技术分享            WritePrivateProfileString(section, key, iValue, this.Path);
39技术分享        }

40技术分享
41技术分享        /// <summary>
42技术分享        /// 读取INI文件
43技术分享        /// </summary>
44技术分享        /// <param name="section">段落</param>
45技术分享        /// <param name="key"></param>
46技术分享        /// <returns>返回的键值</returns>

47技术分享        public string IniReadValue(string section, string key) 
48技术分享        
49技术分享            StringBuilder temp = new StringBuilder(255); 
50技术分享
51技术分享            int i = GetPrivateProfileString(section, key, "", temp, 255this.Path); 
52技术分享            return temp.ToString();
53技术分享        }

54技术分享
55技术分享        /// <summary>
56技术分享        /// 读取INI文件
57技术分享        /// </summary>
58技术分享        /// <param name="Section">段,格式[]</param>
59技术分享        /// <param name="Key"></param>
60技术分享        /// <returns>返回byte类型的section组或键值组</returns>

61技术分享        public byte[] IniReadValues(string section, string key)
62技术分享        {
63技术分享            byte[] temp = new byte[255];
64技术分享
65技术分享            int i = GetPrivateProfileString(section, key, "", temp, 255this.Path);
66技术分享            return temp;
67技术分享        }

68技术分享    }

69技术分享}

70技术分享
<?xml:namespace prefix="o" ns="urn:schemas-microsoft-com:office:office"?>

注意:我增加了DLL导出的函数GetPrivateProfileString的重载,说明如下:

技术分享[DllImport("kernel32")] 
技术分享
private static extern int GetPrivateProfileString(string section, string key, string defVal, Byte[] retVal, int size, string filePath);
技术分享section:要读取的段落名
技术分享key: 要读取的键
技术分享defVal: 读取异常的情况下的缺省值
技术分享retVal: 此参数类型不是string,而是Byte[]用于返回byte类型的section组或键值组。
技术分享size: 值允许的大小
技术分享filePath: INI文件的完整路径和文件名


下面看一下具体实例化IniFile类的操作:

//pathini文件的物理路径

IniFile ini = new IniFile(path);

//读取ini文件的所有段落名

byte[] allSection = ini.IniReadValues(null, null);

 

通过如下方式转换byte[]类型为string[]数组类型

string[] sectionList;

ASCIIEncoding ascii = new ASCIIEncoding();

//获取自定义设置section中的所有keybyte[]类型

sectionByte = ini.IniReadValues("personal", null);

//编码所有keystring类型

sections = ascii.GetString(sectionByte);

//获取key的数组

sectionList = sections.Split(new char[1]{‘\0‘});

 

//读取ini文件personal段落的所有键名,返回byte[]类型

byte[] sectionByte = ini.IniReadValues("personal", null);

 

//读取ini文件evideo段落的MODEL键值

model = ini.IniReadValue("evideo", "MODEL");

 

//将值eth0写入ini文件evideo段落的DEVICE

ini.IniWriteValue("evideo", "DEVICE", "eth0");

即:

[evideo]

DEVICE = eth0

 

//删除ini文件下personal段落下的所有键

ini.IniWriteValue("personal", null, null);

 

//删除ini文件下所有段落

ini.IniWriteValue(null, null, null);

这样就实现了C#对ini文件包括段落section,键key,键值value的基本上所有操作,当然这只是简单的举例,不是详细的实现,欢迎随时提出任何疑问和建议。

关于C#操作INI文件的总结