ini parser

INI文件解析器

a .net，mono和unity3D兼容（*）库，用于从io流，文件流和字符串中读取/写入INI数据。

还实现合并操作，包括完整的INI文件，部分，甚至仅仅是文件包含的键的一个子集。

（*）此库是100％.NET代码，并且对Windows API调用没有任何依赖性，以便便携式。

获取最新版本：https：//github.com/rickyah/ini–parser/releases/latest使用nuget：https：//www.nuget.org/packages/ini-parsers/ini-parser/

2.0版

由于INI格式并不是真正的“标准”，因此版本2引入了一种自定义INI解析的简单方法：

• 将配置对象传递给IniParser ，并指定解析器的行为。如果不提供默认实现，则使用默认实现。

• 源自IniDataParser并覆盖细粒的解析方法。

安装

该库已发布到Nuget，可以从包含解决方案的目录中安装在命令行上。

 > nuget install ini-parser

或者，来自Visual Studio中的软件包管理器控制台

PM > Install-Package ini - parser

如果您使用的是Visual Studio，则可以下载Nuget Package Manager扩展名，该扩展程序将允许为您的项目添加Nuget依赖性。

如果您使用Monodevelop / Xamarin Studio，则可以安装Monodevelop Nuget Addin，以便能够将此库添加为IDE的依赖关系。

入门

所有代码示例都期望以下使用条款：

 using IniParser ;
using IniParser . Model ;

INI数据存储在嵌套词典中，因此访问与部分中的密钥相关的值很简单。使用提供的方法之一加载数据。

 var parser = new FileIniDataParser ( ) ;
IniData data = parser . ReadFile ( \"Configuration.ini\" ) ;

检索指定部分内部的键的值。值总是以string s检索。

 string useFullScreenStr = data [ \"UI\" ] [ \"fullscreen\" ] ;
// useFullScreenStr contains \"true\"
bool useFullScreen = bool . Parse ( useFullScreenStr ) ;

修改字典中的值，而不是检索的值，然后保存到新文件或覆盖中。

 data [ \"UI\" ] [ \"fullscreen\" ] = \"true\" ;
parser . WriteFile ( \"Configuration.ini\" , data ) ;

前往Wiki以获取更多用法示例，或查看示例项目的代码

合并INI文件

合并INI文件是一个单方法操作：

   var parser = new IniParser . Parser . IniDataParser ( ) ;

   IniData config = parser . Parse ( File . ReadAllText ( \"global_config.ini\" ) ) ;
   IniData user_config = parser . Parse ( File . ReadAllText ( \"user_config.ini\" ) ) ;
   config . Merge ( user_config ) ;

   // config now contains that data from both ini files, and the values of
   // the keys and sections are overwritten with the values of the keys and
   // sections that also existed in the user config file

请记住，如果您愿意，可以合并各个部分：

 config [ \"user_settings\" ] . Merge ( user_config [ \"user_settings\" ] ) ; 

评论

该库允许修改INI文件中的注释。但是，注意将文件写回磁盘，评论将被重新排列，因此在他们所指的元素之前写了评论。

要查询，添加或删除注释，请访问SectionData和KeyData模型中可用的属性Comments 。

 var listOfCommentsForSection = config . [ \"user_settings\" ] . Comments ;
var listOfCommentsForKey = config [ \"user_settings\" ] . GetKeyData ( \"resolution\" ) . Comments ; 

Unity3d

您可以在Unity3D项目中轻松使用此库。只需将代码或DLL放入您项目的资产文件夹中，就可以使用！

Ini-parser实际上在ProjectPrefs中使用了Unity Assets Store中的免费附加组件，可让您为项目设置自定义首选项。我不隶属于这个项目：Garrafote的荣誉是为了制作此附加组件。

贡献

您是否有改进此库的想法，还是碰巧遇到了错误？请分享您的想法或您在“问题”页面中发现的错误，甚至更好：随意叉，并通过拉动请求为该项目做出贡献。