INI文件其实是一种具有特定结构的文本文件,它的构成分为三部分,结构如下:
[Section1]
key 1 = value2
key 1 = value2
……
[Section2]
key 1 = value1
key 2 = value2
……
文件由若干个段落(section)组成,每个段落又分成若干个键(key)和值(value)。Windows系统自带的Win32的API函数GetPrivateProfileString()和WritePrivateProfileString()分别实现了对INI文件的读写操作,他们位于kernel32.dll下。
读操作:
[DllImport("kernel32")]
private static extern int GetPrivateProfileString
(
string section, // section:要读取的段落名
string key, // key: 要读取的键
string defValue, // defValue: 读取异常的情况下的缺省值
StringBuilder retValue, // retValue: key所对应的值,如果该key不存在则返回空值
int size, // size: 值允许的大小
string path // path: INI文件的完整路径和文件名
);
写操作:
[DllImport("kernel32")]
private static extern long WritePrivateProfileString
(
string section, // section: 要写入的段落名
string key, // key: 要写入的键,如果该key存在则覆盖写入
string value, // value: key所对应的值
string path // path: INI文件的完整路径和文件名
);
这样,在就可以使用对他们的调用,用常规的方式定义一个名为IniFile类:
using System.Runtime.InteropServices;
using System.Text;
namespace Ini
{
public class IniFile
{
#region DLL
[DllImport("kernel32")]
private static extern int GetPrivateProfileString
(
string section, // section:要读取的段落名
string key, // key: 要读取的键
string defValue, // defValue: 读取异常的情况下的缺省值
StringBuilder retValue, // retValue: key所对应的值,如果该key不存在则返回空值
int size, // size: 值允许的大小
string path // path: INI文件的完整路径和文件名
);
[DllImport("kernel32")]
private static extern long WritePrivateProfileString
(
string section, // section: 要写入的段落名
string key, // key: 要写入的键,如果该key存在则覆盖写入
string value, // value: key所对应的值
string path // path: INI文件的完整路径和文件名
);
[DllImport("kernel32")]
private static extern int GetPrivateProfileString
(
string section, // section:要读取的段落名
string key, // key: 要读取的键
string defValue, // defValue: 读取异常的情况下的缺省值
Byte[] retValue, // retValue: 此参数类型不是string,而是Byte[]用于返回byte类型的section组或键值组。
int size, // size: 值允许的大小
string path // path: INI文件的完整路径和文件名
);
#endregion
public string _path;
public IniFile(string path)
{
this._path = path;
}
/// <summary>
/// 写INI文件
/// </summary>
/// <param name="section">段落</param>
/// <param name="key">键</param>
/// <param name="Value">值</param>
public void Write(string section, string key, string Value)
{
WritePrivateProfileString(section, key, Value, this._path);
}
/// <summary>
/// 读取INI文件
/// </summary>
/// <param name="section">段落</param>
/// <param name="key">键</param>
/// <returns>返回的键值</returns>
public string Read(string section, string key)
{
StringBuilder temp = new StringBuilder(255);
int i = GetPrivateProfileString(section, key, "", temp, 255, this._path);
return temp.ToString();
}
/// <summary>
/// 读取INI文件
/// </summary>
/// <param name="Section">段,格式[]</param>
/// <param name="Key">键</param>
/// <returns>返回byte类型的section组或键值组</returns>
public byte[] ReadB(string section, string key)
{
byte[] temp = new byte[255];
int i = GetPrivateProfileString(section, key, "", temp, 255, this._path);
return temp;
}
}
}
我增加了DLL导出的函数GetPrivateProfileString的重载,说明如下:
[DllImport("kernel32")]
private static extern int GetPrivateProfileString
(
string section, // section:要读取的段落名
string key, // key: 要读取的键
string defValue, // defValue: 读取异常的情况下的缺省值
Byte[] retValue, // retValue: 此参数类型不是string,而是Byte[]用于返回byte类型的section组或键值组。
int size, // size: 值允许的大小
string path // path: INI文件的完整路径和文件名
);
下面看一下具体实例化IniFile类的操作:
//path为ini文件的物理路径
IniFile ini = new IniFile(path);
//读取ini文件的所有段落名
byte[] allSection = ini.IniReadValues(null, null);
通过如下方式转换byte[]类型为string[]数组类型
string[] sectionList;
ASCIIEncoding ascii = new ASCIIEncoding();
//获取自定义设置section中的所有key,byte[]类型
sectionByte = ini.IniReadValues("personal", null);
//编码所有key的string类型
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文件,包括使用Win32 API函数GetPrivateProfileString和WritePrivateProfileString进行读写,以及创建IniFile类进行更方便的处理。示例展示了读取段落名、键值对,写入、修改和删除数据的方法。
2554

被折叠的 条评论
为什么被折叠?



