讲师中心 微信公众号
AI工具推荐 视频效率加速

C#INI文件读写 C#如何操作传统的INI配置文件

冬静吖_9828

冬静吖_9828

发布时间:2026-02-10 10:03:12

|

660人浏览过

|

来源于php中文网

原创

C#中INI文件无原生支持,Windows平台推荐P/Invoke调用GetPrivateProfileString/WritePrivateProfileString;跨平台可选IniParser库,但需注意大小写、BOM及并发安全问题。

c#ini文件读写 c#如何操作传统的ini配置文件

INI文件在C#里没有原生支持,得靠Windows API或第三方库

Windows平台下,GetPrivateProfileString 和 WritePrivateProfileString 是最直接的方案,但它们是Win32 API,需要P/Invoke调用。.NET本身(包括.NET Core/.NET 5+)不提供内置INI解析器——别指望ConfigurationBuilder加个.AddIniFile()就能用,它根本不支持INI格式。

如果你在跨平台项目里硬要用INI,得自己解析(比如按行分割、处理节名[Section]、键值对key=value),但要注意:注释(;或#)、空行、引号包裹值、转义等细节很容易出错。

用P/Invoke调用Win32 API是最轻量、最兼容的做法

适用于Windows桌面应用(WinForms/WPF),且不需要引入额外NuGet包。关键点:

  • GetPrivateProfileString 返回的是实际读取的字符数,不是布尔值;若返回0,不一定失败——可能值为空字符串,得检查lpReturnedString首字节是否为\0
  • 路径必须是绝对路径,相对路径会被解释为相对于当前进程工作目录,而非EXE所在目录
  • 写入时若文件不存在,API会自动创建;但目录不存在则写入失败,不会自动建目录
  • 所有字符串参数必须是string(.NET会自动封送为LPCSTR),不要传StringBuilder给读取函数——除非你手动控制缓冲区大小

示例读取:

Pandas 配置文件报告生成器
Pandas 配置文件报告生成器

使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载
[DllImport("kernel32.dll", CharSet = CharSet.Ansi)]
private static extern uint GetPrivateProfileString(
    string lpAppName, string lpKeyName, string lpDefault,
    StringBuilder lpReturnedString, uint nSize, string lpFileName);

var sb = new StringBuilder(256);
GetPrivateProfileString("Database", "Server", "", sb, (uint)sb.Capacity, @"C:\app\config.ini");
string server = sb.ToString();

用IniParser NuGet包更安全、可跨平台,但要注意默认行为

IniParser(NuGet包名:ini-parser)是目前最成熟的托管INI库,支持.NET Standard 2.0+,能处理注释、多行值、Unicode、节继承等。但它默认把键名转成小写——如果你的INI里有URL和url两个键,会被当成重复键覆盖。

解决方法:

  • 构造FileIniDataParser时传入new IniDataParser(new ParsingRules { CaseSensitive = true })
  • 读取后修改再保存,必须调用parser.WriteFile(path, data),不能只改data["Section"]["Key"]就完事——内存对象修改后不写回磁盘,等于没改
  • 它不自动处理BOM,UTF-8无BOM文件读写最稳;带BOM的文件可能被误判编码,导致乱码

别忽略INI的固有缺陷:它不适合复杂配置

INI没有嵌套结构、没有数组原生语法、不支持类型推断(全是字符串)、无法表达null或布尔真伪(得靠约定如Enabled=1)。如果你的配置项开始出现Item1_Name、Item1_Value、Item2_Name……说明该换JSON或XML了。

另外,多个线程同时读写同一个INI文件极易损坏内容——Win32 API本身不加锁,IniParser也不做并发保护。真要并发访问,得自己加lock或用FileStream配FileShare.None做排他控制。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2275

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3702

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1236

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4279

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7239

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

5004

2024.04.01

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Postman身份认证配置指南
Postman身份认证配置指南

共0课时 | 0人学习

Starlette官方配置指南
Starlette官方配置指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn