一、前言
INI文件，全称为Initialization File（初始化文件），是一种传统的文本型配置文件格式，广泛应用于Windows操作系统及早期应用程序中，用于存储软件的各项设置和参数。
尽管开发中XML、JSON或更现代的配置格式如YAML等逐渐占据主流，但INI文件凭借其简洁明了的结构和易于人类阅读与编辑的特点，在特定场景下仍然具有不可替代的价值。
本文将聚焦于C#语言环境下，介绍如何以最简化的方式实现INI文件的读写操作。
二、INI文件基础
INI文件采用键值对（key-value pairs）的形式组织数据，并将其划分为若干个逻辑段落（sections）。
其基本结构如下：
; 注释行（以分号开始）
[Section1] ; 段落名，用方括号包围
key1 = value1 ; 键值对，等号分隔键与值
key2 = value2
[Section2]
keyA = valueA
keyB = valueB
其中：
注释：以分号（;）开头的行被视为注释，用于解释文件中的设置。
段落（Section）：用方括号（[]）包裹的名称标识一个特定的配置区域，用于分类相关设置。
键（Key）：在每个段落内定义的唯一标识符，用于表示特定的配置项。
值（Value）：与键关联的数据，可以是字符串、数字或其他简单文本表示的信息。
三、C#读写INI文件的最简方法
在C#中，虽然.NET框架并未直接提供对INI文件的内置支持，但可以通过以下两种简便途径实现INI文件的读写：
1、使用Microsoft.VisualBasic命名空间提供的API
尽管名为Visual Basic，但此命名空间中的类库在C#中同样可用。
其中包含了对INI文件操作的便捷方法，无需额外引入外部库或编写复杂的P/Invoke代码。
以下是最简示例：
using Microsoft.VisualBasic.FileIO;
// 读取INI文件
public string ReadIniValue(string section, string key, string filePath)
{
return IniParser.ReadKeyValue(filePath, section, key, "");
}
// 写入INI文件
public void WriteIniValue(string section, string key, string value, string filePath)
{
IniParser.WriteKeyValue(filePath, section, key, value);
}
// 定义辅助类
internal static class IniParser
{
[DllImport("kernel32")]
private static extern int GetPrivateProfileString(string section, string key, string def, StringBuilder retVal, int size, string filePath);
[DllImport("kernel32")]
private static extern int WritePrivateProfileString(string section, string key, string val, string filePath);
internal static string ReadKeyValue(string iniPath, string section, string key, string defaultValue)
{
const int MAX_BUFFER = 65535;
var sb = new StringBuilder(MAX_BUFFER);
GetPrivateProfileString(section, key, defaultValue, sb, MAX_BUFFER, iniPath);
return sb.ToString();
}
internal static void WriteKeyValue(string iniPath, string section, string key, string value)
{
WritePrivateProfileString(section, key, value, iniPath);
}
}
2、利用第三方库
若希望避免直接调用Win32 API，或者寻求更丰富的功能和更好的错误处理，可以选用成熟的第三方库，如IniFileParser或Nini等。
这些库提供了面向对象的接口，简化了INI文件的操作。
以下是一个使用IniFileParser库的简例：
using IniParser;
using IniParser.Model;
// 读取INI文件
public string ReadIniValue(string section, string key, string filePath)
{
var parser = new FileIniDataParser();
IniData data = parser.ReadFile(filePath);
return data[section][key];
}
// 写入INI文件
public void WriteIniValue(string section, string key, string value, string filePath)
{
var parser = new FileIniDataParser();
IniData data = parser.ReadFile(filePath);
data[section][key] = value;
parser.WriteFile(filePath, data);
}
四、结语
尽管INI文件并非现代应用程序首选的配置格式，但在特定需求下，尤其是对于轻量级、跨平台要求不高的项目，其简洁性仍使其成为一个可行的选择。
C#开发可通过使用Microsoft.VisualBasic命名空间提供的API或第三方库，以最简化的代码实现INI文件的读写操作。
这两种方法均能有效满足基本的INI文件处理需求，可根据项目的具体需求和偏好选择合适的方法。
作者：DotNet开发跳槽
觉得有收获？不妨分享让更多人受益
关注「DotNet技术匠」，共同提升技术实力
