C#读写INI文件的最简方法

 更新时间:2025年01月09日 08:32:21   作者:小码编匠  
INI文件,全称为Initialization File(初始化文件),是一种传统的文本型配置文件格式,广泛应用于Windows操作系统及早期应用程序中,本文将聚焦于C#语言环境下,介绍如何以最简化的方式实现INI文件的读写操,需要的朋友可以参考下

一、引言

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,或者寻求更丰富的功能和更好的错误处理,可以选用成熟的第三方库,如IniFileParserNini等。这些库提供了面向对象的接口,简化了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文件处理需求,可根据项目的具体需求和偏好选择合适的方法。

最后

到此这篇关于C#读写INI文件的最简方法的文章就介绍到这了,更多相关C#读写INI文件内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Winform窗体圆角设计代码

    Winform窗体圆角设计代码

    这篇文章主要为大家详细介绍了Winform窗体圆角设计代码,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-01-01
  • C#图像颜色聚类高效方法实例

    C#图像颜色聚类高效方法实例

    这篇文章主要介绍了C#图像颜色聚类高效方法,实例分析了C#实现图像颜色聚类的方法,需要的朋友可以参考下
    2015-04-04
  • C#中静态方法和实例化方法的区别、使用

    C#中静态方法和实例化方法的区别、使用

    这篇文章主要介绍了C#中静态方法和实例化方法的区别、使用,文中讲解的非常细致,对大家的学习有所帮助,感兴趣的朋友可以了解下
    2020-06-06
  • C#实现Word转PDF的方法总结

    C#实现Word转PDF的方法总结

    这篇文章主要为大家详细介绍了C#中实现Word转PDF的常用方法,文中的示例代码讲解详细,具有一定的学习价值,有需要的小伙伴可以参考下
    2023-10-10
  • C# 和 Python 的 hash_md5加密方法

    C# 和 Python 的 hash_md5加密方法

    这篇文章主要介绍了C# 和 Python 的 hash_md5加密方法,文章围绕着C# 和 Python 的 hash_md5加密的相关资料展开文章的详细呢偶然,需要的朋友可以参考一下,希望对你有所帮助
    2021-11-11
  • 深入Unix时间戳与C# DateTime时间类型互换的详解

    深入Unix时间戳与C# DateTime时间类型互换的详解

    本篇文章是对Unix时间戳与C# DateTime时间类型互换进行了详细的分析介绍,需要的朋友参考下
    2013-06-06
  • C#中如何获取文件图标

    C#中如何获取文件图标

    这篇文章主要介绍了C#中如何获取文件图标的相关资料,需要的朋友可以参考下
    2016-03-03
  • WPF实现上下滚动字幕效果

    WPF实现上下滚动字幕效果

    这篇文章主要为大家详细介绍了WPF实现上下滚动字幕效果,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-10-10
  • 一则C#简洁瀑布流代码

    一则C#简洁瀑布流代码

    最近想实现数据的延迟加载,网上找一下有很多例子,看了Masonry的例子启发,自己写了一个很简洁的代码。分享给大家
    2014-06-06
  • C#创建临时文件的方法

    C#创建临时文件的方法

    这篇文章主要介绍了C#创建临时文件的方法,涉及C#中Path.GetTempFileName方法获取与操作临时文件的使用技巧,非常具有实用价值,需要的朋友可以参考下
    2015-04-04

最新评论