.NET开源类库Nini手册（INI、XML、注册表的配置应用）-中文翻译

目录

  • 1.简介

    • 1.1什么是应用程序配置数据？
    • 1.2问题
    • 1.3介绍Nini
  • 2.入门
    • 2.1一个简单的例子
    • 2.2默认值
    • 2.3设置、保存和删除键
    • 2.4添加和删除配置
    • 2.5键值扩展
  • 3.高级主题
    • 3.1合并
    • 3.2价值别名
    • 3.3键值清单
    • 3.4活动
  • 4.配置类型
    • 4.1 Ini文件
    • 4.2 XML文件
    • 4.3 Windows注册表配置
    • 4.4 .NET配置文件
    • 4.5命令行（Argv）配置
  • 5.有效使用Nini
    • 5.1多个用户的处理配置
    • 5.2在数据库中存储配置数据
    • 5.3自动创建配置文件
    • 5.4以编程方式创建配置文件
    • 5.5为您的应用程序选择正确的配置文件类型
  • 附件：获取Nini

@(目录)

Nini .NET配置库（http://nini.sourceforge.net/）
VB代码的注释我保留了原文注释，它和C#注释的内容是一样的，下载链接在文章末尾。

1.简介

1.1什么是应用程序配置数据？

作为开发人员，您始终需要处理应用程序配置数据。常见的示例是INI 文件，XML文件， .NET配置文件（也称为“ .config”），Windows注册表和命令行（argv）参数。配置文件的优点是它们加载速度快，不占用大量空间且易于编辑。

1.2问题

尝试创建配置文件访问方案不能满足程序员或最终用户的需求。为了给出真实的生活场景，我为一个使用Windows注册表API（应用程序编程接口）配置其原始程序的组织工作。后来，他们开发了自己的ASP配置类。大约在同一时间，另一个小组开发了一个API，该API可从数据库中获取数据。然后，当ASP.NET出现时，他们开始使用Web.config。在短短的几年之内，配置数据源的数量就从一增加到了四个！不用说，获取配置数据通常成为一项艰巨的任务。以下是可以改进配置管理的三个主要方面：

  • API
    开发人员使用配置文件格式，以使其应用程序在尽可能短的时间内运行。但是，通常在事后才添加用于访问此数据的API，从而导致API不够灵活。在很小的应用程序中，这可能不是问题，但是随着程序代码库的增长，配置信息通常会遍及整个应用程序代码。
  • 最终用户
    配置文件通常不会考虑最终用户。通常，配置选项是简洁的编程术语，只有最勇敢的用户才敢更改它们。这导致开发人员不得不编写复杂的配置文件编辑器，或更糟糕的是，它们会完全重新设计其原始API。
  • 多个配置源
    随着您软件的成熟，添加更多应用程序配置类型的情况并不少见（例如我之前给您的示例）。这通常是由于合并其他项目中的代码，新的改进格式以及迁移到不同的编程平台而引起的。这迫使程序员学习多个API。最终结果是代码不一致，也不适合新程序员。不会替换旧的配置文件，因为程序员及其经理不适应更改成熟的代码。编辑文件的用户可以抵制此更改，因为他们希望不学习新的文件格式。

1.3介绍Nini

Nini是一个功能强大的 .NET配置 库，旨在帮助快速构建高度可配置的应用程序。Nini提供了一种解决方案，试图消除上述问题。它提供了一个大型功能集，可为您提供从概念到成熟产品的每个阶段都将使用的功能。这是通过简单但灵活的API实现的，该API提供了对基础配置源的抽象。它解决了我上面描述的所有问题。我们将在下面的示例中看到如何完成此操作。

2.入门

2.1一个简单的例子

为了向您展示Nini如何解决这些问题，让我们来看一个示例。首先，让我们看一个示例配置文件。对于本手册中的大多数示例，我将选择INI 格式。INI文件是一种久经考验的真实配置文件类型，用于诸如MySQL，PHP和Samba之类的著名开源项目 。实际上，Nini支持多种INI文件类型。它们非常简单且易于编辑，因此仍然是非常受欢迎的选择。Nini包含它自己的INI解析器类（IniDocument），该类 完全用C＃编写，没有 Windows API代码，因此它是跨平台的。这是此示例的MyApp.ini文本：

; MyApp.ini
[Logging]
File Name = MyApp.log
MessageColumns = 5
MaxFileSize = 40000000000000

以下是一段C＃示例代码，它描述了如何从上述文件中的INI文件访问配置数据：

using Nini.Config;
IConfigSource source = new IniConfigSource("MyApp.ini");

string fileName = source.Configs["Logging"].Get("File Name");
int columns = source.Configs["Logging"].GetInt("MessageColumns");
long fileSize = source.Configs["Logging"].GetLong("MaxFileSize");

这是VB中的示例：

Imports Nini.Config

Dim source As New IniConfigSource("MyApp.ini")

Dim fileName As String = source.Configs("Logging").Get("File Name")
Dim columns As Integer = source.Configs("Logging").GetInt("MessageColumns")
Dim fileSize As Long = source.Configs("Logging").GetLong("MaxFileSize")

好的，那个例子给您带来了一些麻烦。首先，我们使用Nini.Config将Nini的配置名称空间包含在虚构的应用程序中。接下来，我们使用IniConfigSource 类加载INI文件。在Nini中，每种配置文件类型都有其自己的“ Source”类。此类知道如何加载和保存文件。这些类中的每一个都实现IConfigSource 接口，因此您可以更轻松地抽象地使用多种配置类型。加载文件后，所有部分（在本例中为[Logging]部分）都将转换为接口IConfig。 并添加到Source类的集合中。IConfig类提供了非常快速的访问权限，以检索，添加或删除配置密钥（例如上述INI文件中的“文件名”）。IConfig类的方法包括 Get， GetString， GetInt， GetFloat， GetDouble和GetLong 方法。所有以“ Get”为前缀的方法都将重载以提供更多数据。接下来的几节描述了如何使用这些重载。

2.2默认值

有时，配置文件中不会出现选项。这可能是因为尚未将其添加到项目的主版本中，或者应将其对用户保密。对于这些情况，Nini提供了重载的方法，这些方法允许程序员定义默认值。

这是C＃中的示例：

// 将缺少默认值设置为 "Default result".
string missing = config.Get("Missing Config", "Default result");

// 设置smallNumber为默认值，50
int smallNumber = config.GetInt("Not Present", 50);

这是VB中的相同示例：

' Sets missing to the default value, "Default result".
Dim missing As String = config.Get("Missing Config", "Default result")

' Sets smallNumber to the default value, 50.
Dim smallNumber As Integer = config.GetInt("Not Present", 50)

2.3设置、保存和删除键

也可以设置新值并将其保存到配置文件中。调用Set方法将更改现有值，或者如果不存在则将其添加。这是一个例子：

config.Set("File Name", "MyNewFile.log");
config.Set("MessageColumns", 45);
config.Remove("File Name");

source.Save();

但是，有必要调用Save方法来保存文件，但是，您还可以在IConfigSource上设置AutoSave属性，并且每次调用Set方法时，该属性都会自动保存文件。如果要将文档保存到其他路径或对象，则IniConfigSource， XmlConfigSource和DotNetConfigSource 类都保存重载的Save方法，这些方法使您可以保存到新路径或TextWriter：

这是C＃中的示例：

using System.IO;

IniConfigSource source = new IniConfigSource("Test.ini");
StringWriter writer = new StringWriter();
source.Save(writer); // 保存到StringWriter（TextWriter）

source.Save("some/new/path.ini"); // 保存到新路径

这是VB中的示例：

Imports System.IO

Dim source As IniConfigSource = new IniConfigSource("Test.ini")
Dim writer As New StringWriter()
source.Save(writer) ' Save to StringWriter(TextWriter)

source.Save("some/new/path.ini") ' Save to new path

2.4添加和删除配置

在特定情况下，您将需要自己添加和删除IConfigs。Nini具有完成这两项操作的简单方法。这是我创建新配置然后立即将其删除的示例。

这是C＃中的示例：

IConfig newConfig = source.AddConfig("NewConfig");

source.Configs.Remove(newConfig);

这是VB中的示例：

Dim newConfig As IConfig = source.AddConfig("NewConfig")

source.Configs.Remove(newConfig)

2.5键值扩展

在许多情况下，您会发现您的键值取决于其他键的值。例如，您有一个根路径配置值，以及使用此路径的文件的多个值，例如以下示例：

[File Path]
RootPath = C:\Program Files\My Program
Logging = MyApp.log
WebPage = index.html

如果没有Nini，则如果要将“ RootPath”的值与“ Logging”和“ WebPage”结合使用，则必须执行难看的字符串连接才能获得“ C：?Program Files ?My Program ?index.html”。在Nini中，您不需要这样做：

[File Path]
RootPath = C:\Program Files\My Program
Logging = ${RootPath}\MyApp.log
WebPage = ${RootPath}\index.html

这可以为您自己串联它们省去很多麻烦，并使您的代码更整洁。如果要从其他部分获取值，则可以执行上述操作，但是要在部分名称后添加一个横条（“ |”），如下所示：$ {section | key}。当您准备执行替换时，请调用ExpandKeyValues（注意：以前称为ReplaceKeyValues）

这是C＃中的示例：

IConfigSource source = new IniConfigSource("MyApp.ini");
source.ExpandKeyValues();

这是VB中的示例：

Dim source As New IConfigSource("MyApp.ini")
source.ExpandKeyValues()

调用ExpandKeyValues时，它会一次更改配置文件中的所有键。这使代码执行更快，因为它不需要替换每个Get / GetString / GetInt / etc调用上的键值。但是，这意味着如果要使用保存配置文件，它将用扩展值覆盖以前的值。如果您不希望发生这种情况，则可以使用GetExpanded方法。

; 这会将日志记录设置为 "C:\Program Files\My Program\MyApp.log"
IConfigSource source = new IniConfigSource("MyApp.ini");
string logging = source.Configs["File Path"].GetExpanded("Logging");

这就是创建第一个Nini配置的应用程序很容易。以下各节将介绍Nini的一些更高级的功能。

3.高级主题

3.1合并

合并是一项非常强大的功能，允许开发人员将来自多个源的配置数据组合到一个对象中。您可以将无数种不同的配置类型组合到一个IConfigSource中！您可以将多个INI，XML和注册表文件添加到同一对象中。你觉得很酷吗？这是一个如何将INI文件与XML文件合并的示例。

这是C＃中的示例：

IConfigSource mainSource = new IniConfigSource("MyApp.ini");
IConfigSource xmlSource = new XmlConfigSource("MyApp.xml");
mainSource.Merge(xmlSource);

// 现在，您可以从mainSource和xmlSource访问任何IConfig
string xmlValue = mainSource.Configs["SomeXmlSection"].Get("AnOption");

这是VB中的示例：

Dim mainSource As New IniConfigSource("MyApp.ini")
Dim xmlSource As New XmlConfigSource("MyApp.xml")
mainSource.Merge(xmlSource)

' Now you can access any IConfig from mainSource and xmlSource
Dim xmlValue As String = mainSource.Configs("SomeXmlSection").Get("AnOption")

当数据在文件之间合并时，任何同名的IConfig或包含相同密钥的IConfig都将覆盖之前的文件。对于具有不同配置需求的客户端的用户来说，这非常重要。您可以在一个文件中创建默认配置设置，并具有特定于客户端的文件，如果需要，该文件将覆盖主文件的设置。这将节省您大量的工作。它对我有用。

3.2价值别名

许多配置文件的选项对于程序员来说是清楚的，但对非程序员来说却很混乱。为了使非程序员更容易理解配置文件，一种常见的做法是使键和值更像普通的人类对话框那样读取。让我们看一个示例，说明如何使用易于理解的字符串值返回布尔值。首先，让我们从AliasExample INI文件开始：

; AliasExample.ini
[Web Browser]
Block Popups = ON
Check For Default Browser = Off
Error Level = warn

如您所见，我不是使用每个键的值都使用“ 1”或“ true”之类的值，而是使用了“ On”和“ Off”，希望它们可以使用户更容易理解。您还将注意到，每个值之间的大小写不完全是大写或小写。我这样做是为了提出观点。用户很难记住要在特定键值中放置什么值，因此要使它们变得更容易一点也不 要使他们也记住要使用哪种情况！忽略大小写的问题是您的代码看起来很丑陋，如以下示例所示：

bool blockPopUps = (config.Get("Block Popups").ToLower() == "on");

让我们为该文件定义一些规则，使它们成为规则。我们希望 BlockPopUps部分的 值在值设置为“ On”时返回布尔值true，而在值设置为“ Off”时返回false值。此外，我希望错误级别将整数值设置为“ Warn”时返回100，而将值设置为“ Error”时返回200。下面的代码显示如何向IConfigSource的Alias属性添加规则，该属性定义了我在上一段中刚刚定义的规则。

这是C＃中的示例：

IConfigSource source = new IniConfigSource("AliasExample.ini");

// 创建两个布尔别名。
source.Alias.AddAlias("On", true);
source.Alias.AddAlias("Off", false);

// 设置两个整数别名。
source.Alias.AddAlias("Error Level", "Warn",  100);
source.Alias.AddAlias("Error Level", "Error", 200);

IConfig config = source.Configs["Web Browser"];
bool blockPopUps = config.GetBoolean("BlockPopUps");
int errorCode = config.GetInt("Error Code", true);

这是VB中的示例：

Dim source As New IniConfigSource("AliasExample.ini")

' Creates two Boolean aliases.
source.Alias.AddAlias("On", True)
source.Alias.AddAlias("Off", False)

' Sets two integer aliases.
source.Alias.AddAlias("Error Level", "Warn",  100)
source.Alias.AddAlias("Error Level", "Error", 200)

Dim config As IConfig = source.Configs("Web Browser")
Dim blockPopUps = config.GetBoolean("BlockPopUps")
int errorCode = config.GetInt("Error Code", True)

对AddAlias的前两个调用 将布尔值添加到文本“ On”和“ Off”。此方法的接下来的两个调用将别名文本添加到“错误级别”配置中，并将文本分别为“警告”和“错误”以及数字值100和200。接下来，我获取了关键数据。GetInt方法已重载，因此，如果参数设置为true，则它将以别名而不是文字整数值加载数据。

3.3键值清单

Nini没有用于返回信息列表的专用方法。这是因为 .NET Framework 的String.Split方法已经有了使用小技巧的 方法。这是一个INI文件，其中服务器列表由竖线（“ |”）分隔符分隔：

[MailServers]
ServerList = "http://mail.yahoo.com/|http://www.hotmail.com/|http://www.mail.com/"

现在，使用Split方法，我们将服务器列表作为字符串数组返回：

string[] serverList = source.Configs["MailServers"].Get("ServerList").Split('|');

这是VB中的示例：

Dim serverList() As String = source.Configs("MailServers").Get("ServerList").Split('|')

您可以使用Split方法使用任意数量的分度器。要有创造力。只需选择一个不会用作键值的分度符即可。

3.4活动

Nini允许开发人员以非连接方式执行操作，从而使事情变得容易。通常，第一个对象可以只使用IConfig，而不必担心其他对象如何使用它。但是，有时候知道更改配置数据的时间很有用。Nini添加了许多事件来帮助处理这些情况。

在以下情况下，类需要在保存IConfigSource时通知。

这是一个C＃示例：

void SourceLoad()
{
  source = new IniConfigSource();
  source.Saved += new EventHandler(this.source_Saved);
}

void source_Saved(object sender, EventArgs e)
{
  // 在这里执行保存操作
}

这是一个VB示例：

Sub SourceLoad()
{
  source = New IniConfigSource()
  source.Saved += New EventHandler(Me.source_Saved)
}

Sub source_Saved(sender As object, e As EventArgs) Handles source.Saved
{
  ' perform save actions here
}

还有更多事件，例如Load，KeySet，KeyRemoved，ConfigAdded和ConfigRemoved。

4.配置类型

4.1 Ini文件

Nini具有使用100％C＃编写的内置INI解析器。这意味着，与其他INI解析器不同，它将在任何.NET平台上运行，而不仅仅是运行Windows的平台。另外，解析器的编写旨在提高灵活性，这就是为什么它支持多种INI文件类型的原因。当前支持的文件类型如下：

  • Windows style (Win32 API GetPrivateProfileString)
  • MySQL style
  • Python Style
  • Samba style
  • Nini standard
    区分大小写
    IniConfigSource类具有一个允许值不区分大小写的属性。对于使用不区分大小写的旧Win32 API GetPrivateProfileString函数从系统升级软件的人们，这可能是理想的。这是一个如何使用它的示例：
; 注意，load方法只是将文件名传递给构造函数的替代方法。
IConfigSource source = new IniConfigSource();
source.Load("MyApp.ini");
source.CaseSensitive = false;

4.2 XML文件

Nini拥有自己的XML配置文件结构。与.NET配置文件格式相比，它提供了更大的灵活性。它的主要优点是您可以拥有多个XML配置文件，并且格式更加简洁。这是格式的示例。您会发现它非常类似于INI文件。配置值与先前示例中的INI相同：

<!-- MyApp.xml -->
<Nini>
    <Section Name="Logging">
        <Key Name="File Name" Value="MyApp.log" />
        <Key Name="MessageColumns" Value="5" />
        <Key Name="MaxFileSize" Value="40000000000000" />
    </Section>
</Nini>

加载文件非常简单：

// 加载XML文件
XmlConfigSource source = new XmlConfigSource("MyApp.xml");
// 检索值
long maxFileSize = source.Configs["Logging"].GetLong("MaxFileSize");

这是VB中的示例：

' Loads the XML file
Dim source As New XmlConfigSource("MyApp.xml")
' Retrieves a value
Dim maxFileSize As Long = source.Configs("Logging").GetLong("MaxFileSize")

4.3 Windows注册表配置

如果您使用的是许多Microsoft Windows操作系统之一，则可以从Windows注册表访问数据。这是注册表项的示例键路径：

HKEY_LOCAL_MACHINE\Sofware\MyApp\Logging
"File Name"       "MyApp.log"  REG_SZ
"MessageColumns"  "5"          REG_DWORD
"MaxFileSize"     "40000000"   REG_DWORD

要访问此代码，该方法比其他方法要复杂一些。您必须创建到注册表项的映射。此功能还将使您能够将许多注册表项合并到一个IConfigSource中。这是一些访问它的示例代码。

这是C＃中的示例：

using Microsoft.Win32;
RegistryConfigSource source = new RegistryConfigSource();
// 加载注册表树
source.AddMapping(Registry.LocalMachine, "Software\\MyApp\\Logging");
// 检索值
long maxFileSize = source.Configs["Logging"].GetLong("MaxFileSize");

这是VB中的示例：

Imports Microsoft.Win32
Dim source As New RegistryConfigSource()
' Loads the registry tree
source.AddMapping(Registry.LocalMachine, "Software\\MyApp\\Logging")
' Retrieves a value
Dim maxFileSize As Long = source.Configs("Logging").GetLong("MaxFileSize")

如果您想递归地检索指定注册表项下的所有数据，也可以使用一种方法来完成。

如果要使所有子键位于具有统一名称的键下，则可以执行以下操作：

using Microsoft.Win32;
// 加载注册表树及其下的所有节点
RegistryConfigSource source = new RegistryConfigSource();
source.AddMapping(Registry.LocalMachine, "Software\\MyApp", RegistryRecurse.Flattened);

string maxFileSize = source.Configs["MyApp"].GetString("SomeConfig");
long maxFileSize = source.Configs["Logging"].GetLong("MaxFileSize");

这是VB中的示例：

Imports Microsoft.Win32
' Loads the registry tree and all nodes beneath it without
Dim source As New RegistryConfigSource()
source.AddMapping(Registry.LocalMachine, "Software\\MyApp", RegistryRecurse.Flattened)

Dim maxFileSize As String = source.Configs("MyApp").GetString("SomeConfig");
Dim maxFileSize As Long = source.Configs("Logging").GetLong("MaxFileSize")

4.4 .NET配置文件

.NET Framework具有使用特定XML格式的自己的配置文件机制 。您可能在ASP.NET中以web.config 文件的形式熟悉它们。如果将它们与Windows窗体，控制台应用程序或服务一起使用，则将它们称为[APP NAME] .exe.config文件。为了支持仍在其应用程序中使用此配置文件格式的用户，Nini也支持这些文件。

<!-- ExampleApp.exe.config -->
<configuration>
    <configSections>
        <section name="Logging" type="System.Configuration.NameValueSectionHandler" />
    </configSections>
    <Logging>
        <add key="File Name" value="MyApp.log" />
        <add key="MessageColumns" value="5" />
        <add key="MaxFileSize" value="40000000000000" />
    </Logging>
</configuration>

访问数据与加载INI或XML文件非常相似：

IConfigSource source = new DotNetConfigSource(DotNetConfigSource.GetFullConfigPath());

string fileName = source.Configs["Logging"].Get("File Name");
int columns = source.Configs["Logging"].GetInt("MessageColumns");
long fileSize = source.Configs["Logging"].GetLong("MaxFileSize");

这是VB中的示例：

Dim source As New DotNetConfigSource(DotNetConfigSource.GetFullConfigPath())

Dim fileName As String = source.Configs("Logging").Get("File Name")
Dim columns As Integer = source.Configs("Logging").GetInt("MessageColumns")
Dim fileSize As Long = source.Configs("Logging").GetLong("MaxFileSize")

4.5命令行（Argv）配置

自从编程开始以来，应用程序就具有接受命令行开关的能力。这些开关只是在应用程序首次启动时传递给应用程序的字符串。Windows程序Xcopy具有许多命令行 开关 ，而出色的下载应用程序wget也具有其自己的 开关 。如果您想更多地了解.NET中命令行参数的工作方式， 请单击此处（链接无效）。我们的第一个示例与您迄今为止看到的其他示例非常相似。区别在于 AddSwitch 需要为每个键配置调用方法。有一个短键和一个长键可用于获取配置数据。

这是C＃中的示例：

public static int Main(string[] args)
{
   ArgvConfigSource source = new ArgvConfigSource(args);

   source.AddSwitch("Logging", "file-name", "f");
   source.AddSwitch("Logging", "columns", "c");
   source.AddSwitch("Logging", "max-file-size", "m");

   if(args.Length > 0)
   {
      string fileName = source.Configs["Logging"].Get("file-name");
      int columns = source.Configs["Logging"].GetInt("columns");
      long fileSize = source.Configs["Logging"].GetLong("max-file-size");
   }
}

这是VB中的示例：

Public Static Function Main(args() As String) As Integer
   Dim source As New ArgvConfigSource(args)

   source.AddSwitch("Logging", "file-name", "f")
   source.AddSwitch("Logging", "columns", "c")
   source.AddSwitch("Logging", "max-file-size", "m")

   If (args.Length > 0) Then
      Dim fileName As String = source.Configs("Logging").Get("file-name")
      Dim columns As Integer = source.Configs("Logging").GetInt("columns")
      Dim fileSize As Long = source.Configs("Logging").GetLong("max-file-size")
   End If
End Function

5.有效使用Nini

5.1多个用户的处理配置

您可能会注意到，.NET 1.0和1.1的ConfigurationSettings类仅提供检索配置值的方法。这是因为对于程序员来说，以编程方式更改整个应用程序的配置值通常是一个坏主意。全局配置应用程序的方式由管理员决定。因此，我建议您不要更改应用程序级别设置。

但是，至关重要的是，您必须允许用户根据自己的个人喜好配置应用程序。Nini允许您创建许多不同的配置文件源，因此只需将配置文件放在正确的目录中即可。Windows程序的标准是应用程序数据目录：

C:\Documents and Settings[username]\Local Settings\Application Data[Application Name]\Settings.ini

您可以通过以下路径以编程方式获取此路径：

string folder = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData);

5.2在数据库中存储配置数据

如果您正在运行ASP.NET应用程序，则每个系统中可能会有多个用户。您可能还需要编辑许多用户设置。大多数Web应用程序都完全配置有数据库，因此以下是将Nini与数据库一起使用的示例。

这是一个带有SQL Server表的非常简单的示例。这可以很容易地适应任何其他数据库。这是数据库表的结构：

CREATE TABLE UserSettings
(
   UserId ID,
   Settings TEXT
);

ConfigSettings字段存储Nini配置值。现在，您可以像这样加载Nini配置值：

string userId = GetUserId(); // retrieve the user id somehow

SqlCommand command = new SqlCommand("SELECT Settings FROM UserSettings WHERE ID = "
                                     + userId, connection);

connection.Open();

SqlDataReader reader = command.ExecuteReader();

if(reader.HasRows) {
    reader.Read();
    IConfigSource source = new XmlConfigSource(new StringReader(reader.GetString(0)));
}

reader.Close();
connection.Close();

5.3自动创建配置文件

对于任何开发项目而言，能够自动创建构建都是必不可少的。有几种工具可以完成此任务，例如批处理（.bat）脚本，但是.NET Framework最受欢迎的选择可能是 NAnt。您可能会发现自己需要使用构建管理系统来创建配置文件。为了使这些工作更轻松，Nini项目提供了NiniEdit（Nini命令行配置编辑器）。使用此应用程序，您可以创建和编辑任何基于文件的配置数据。NiniEditor包含在Examples目录中的每个Nini版本中。

让我们添加一个示例，说明如何在构建中使用NiniEdit。在第一个示例中，假设您的构建是一个批处理文件，并且您需要以编程方式创建以下INI文件：

[General]
Debug = false
Logging = On
[Logging]
FilePath = C:\temp\MyApp.log

以下调用将自动创建配置文件：

:: Create the new configuration file
niniedit --new --set-type=ini MyApp.ini
niniedit --add=General MyApp.ini
niniedit --add=Logging MyApp.ini
niniedit --config=General --set-key=Debug,false MyApp.ini
niniedit --config=General --set-key=Logging,On MyApp.ini
niniedit --config=Logging --set-key=FilePath,C:\temp\MyApp.log MyApp.ini

如果您在NAnt中执行相同的操作，则可以执行以下操作：

<exec program="niniedit" commandline="-n -s INI MyApp.ini" />
<exec program="niniedit" commandline="-a General MyApp.ini" />
<exec program="niniedit" commandline="-a Logging MyApp.ini" />
<exec program="niniedit" commandline="-c General -k Debug,false MyApp.ini" />
<exec program="niniedit" commandline="-c General -k Logging,On MyApp.ini" />
<exec program="niniedit" commandline="-c Logging -k FilePath,C:\temp\MyApp.log MyApp.ini" />

这里的所有都是它的。NiniEdit具有其他功能，例如列出配置，键，键值和删除键的功能。如果没有其他问题，请以NiniEdit为例，说明如何使用Nini编写自己的命令行应用程序。

5.4以编程方式创建配置文件

有时，使用应用程序以编程方式创建配置文件可能会很有用。使用Nini进行此操作非常容易。

假设您要创建在任一示例中创建的相同INI文件：

[General]
Debug = false
Logging = On
[Logging]
FilePath = C:\temp\MyApp.log

在代码中创建代码的方法如下：

IniConfigSource source = new IniConfigSource();

IConfig config = source.AddConfig("General");
config.Set("Debug", "false");
config.Set("Logging", "On");

config = source.AddConfig("Logging");
config.Set("FilePath", "C:\\temp\\MyApp.log");

source.Save("MyApp.ini");

5.5为您的应用程序选择正确的配置文件类型

Nini的编写旨在使所有配置文件类型都成为一流公民。这是因为每种配置文件类型都有其自身的优点和缺点。下面的列表包含一些基本准则：

INI

  • 速度-文件类型的解析速度非常快，因此它的加载和保存速度可能比其他类型更快。
  • 可读性-在配置类型中，这可能对用户最不可怕。如果您要让用户手动更改此配置文件，那么我强烈建议您使用此格式。
  • 安装程序-INI文件受许多类型的安装程序支持（Wise，NSIS，仅举几例）。如果您需要构建来编辑这些文件，那么绝对可以这样做。

XML

  • 速度-XML解析器要加载很多信息，因此这可能是最慢的。
  • 可读性-这种格式对于初学者来说有点吓人。
  • 支持-所有编程语言都支持此功能，因此，如果其他应用程序正在访问数据，那么这是一个很好的类型。
  • 安装程序-由于配置文件没有标准的XML格式，因此安装程序通常不支持此格式。

.NET配置文件

  • 速度-XML解析器要加载很多信息，因此这可能是最慢的。
  • 可读性-这种格式对于初学者来说有点吓人。
  • 安装程序-.NET Framework将这些配置文件用于其他配置。如果将.NET配置和您自己的应用程序配置选项混合使用，我建议不要使用它。

Windows注册表

  • 速度-快速检索配置数据。随着注册表越来越多地填充数据，检索速度的确会变慢。这被认为是定期重新安装Windows可以使计算机运行更快的原因之一。
  • 可读性-如果您确实不希望用户能够配置应用程序，则应使用此类型。触摸注册表可能会导致严重问题，因此建议除非必要，否则不要使用它。但是，请注意，如果您的支持人员需要用户调整配置设置，他们将遇到与用户相同的问题。除此之外，配置文件编辑器是众所周知的并且很成熟。
  • 安装程序-大多数安装程序支持读取和编辑注册表项，因此这是一个不错的选择。
    没有完美的配置类型，因为每个配置都有自己的优势。如果最终选择的配置文件类型不适合您的情况，则不要惊慌。Nini提取了您要访问的文件类型，因此您必须更改的代码量应该最少。

本教程就是这样。希望对您有所帮助！如果您有任何关于改进本手册的问题或建议，请访问Nini主页，并使用论坛，错误跟踪器或功能请求工具来表达自己的意见。

附件：获取Nini

原文地址：https://www.cnblogs.com/timefiles/p/NiniManualTranslation.html

时间： 2024-10-18 09:24:01

.NET开源类库Nini手册（INI、XML、注册表的配置应用）-中文翻译的相关文章

RegOpenKey(注册表定位器) 1.5 中文免费绿色版

软件名称: RegOpenKey(注册表定位器) 1.5 中文免费绿色版 软件语言: 简体中文 授权方式: 免费软件 运行环境: Win7 / Vista / Win2003 / WinXP / Win2008 软件大小: 655KB 图片预览: 软件简介: 注册表定位器,一键打开转到注册表. 例如,你要打开注册表的HKEY_LOCAL_MACHINE的位置,你只需要复制这个地址,然后双击安装包中的软件即可进入到注册表的这个地方! 软件下载页面:http://www.bkill.com/down

Win.ini和注册表的读取写入

Win.ini文件的读写 PlatForm SDK的WriteProfileString()函数可以写入一个字符串到Win.ini文件的制定段中 PlatForm SDK的GetProfileString()函数可以从Win.ini文件中获得指定的段中制定键的字符串信息. /**************************************************************************                    往WIN.ini文件中写入内容和读取

Tmocat的service.xml配置文件详解（含中文翻译）

Tmocat的service.xml配置文件 英文原版 中文手译 <?xml version='1.0' encoding='utf-8'?> <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements.  See the NOTICE file distributed with this work for additional informa

【读书笔记】C#高级编程 第二十四章 文件和注册表操作

(一)文件和注册表 对于文件系统操作,相关的类几乎都在System.IO名称空间中,而注册表操作由System.Win32名称空间中的类来处理. (二)管理文件系统 System.MarshalByRefObject--这是.NET类中用于远程操作的基对象类,它允许在应用程序域之间编组数据. FileSystemInfo--这是表示任何文件系统对象的基类. FileInfo和File--这些类表示文件系统上的文件. DirectoryInfo和Directory--这些类表示文件系统上的文件夹.

详解Windows注册表分析取证

大多数都知道windows系统中有个叫注册表的东西,但却很少有人会去深入的了解它的作用以及如何对它进行操作.然而对于计算机取证人员来说注册表无疑是块巨大的宝藏.通过注册表取证人员能分析出系统发生了什么,发生的时间以及如何发生的等.在本文中我将为大家详细介绍Windows注册表的工作原理,以及如何对收集用户留下的各类指纹信息. 什么是注册表? 注册表是用于存储Windows系统用户,硬件和软件的存储配置信息的数据库.虽然注册表是为了配置系统而设计的,但它可以跟踪用户的活动,连接到系统的设备,什么时

性能测试：通过设置注册表提高 P2P/IIS 并发数

写在前面 在执行性能测试(如用 JMeter 直接压接口)的时候,有的时候并发数上不去.本机大面积出现 TCP 状态为 TIME_WAIT,除了放开 TCP 端口数和调整默认 TCP 释放时间外,另外几个注册表项同样重要且需要调整. 以下设置项针对的是本机和远端机. 设置完成后,重启下电脑使生效. 增加TCP 连接数:TcpNumConnections [HKLM\System\CurrentControlSet\Services\Tcpip\Parameters] TcpNumConnecti

dropzonejs中文翻译手册 DropzoneJS是一个提供文件拖拽上传并且提供图片预览的开源类库.

http://wxb.github.io/dropzonejs.com.zh-CN/dropzonezh-CN/ 由于项目需要,完成一个web的图片拖拽上传,也就顺便学习和了解了一下前端的比较新的技术:HTML5的api,作为一名前端的菜鸟,没什么可说的,直接分享自己学习的资料: 关于HTML5 的这些新的特性大家可以到Mozilla的开发者社区MDN https://developer.mozilla.org/zh-CN/ 上查HTML5的资料 还有就是发掘到的比较牛逼的一篇博客:http:/

浅谈 Java 主流开源类库解析 XML

在大型项目编码推进中,涉及到 XML 解析问题时,大多数程序员都不太会选用底层的解析方式直接编码. 主要存在编码复杂性.难扩展.难复用....,但如果你是 super 程序员或是一个人的项目,也不妨一试. Jdom/Dom4j/Xstream... 基于底层解析方式重新组织封装的开源类库,简洁明了的 API,稳定高效的运行表现. Dom4j 基于 JAXP 解析方式,性能优异.功能强大.极易使用的优秀框架.想了解底层解析方式请翻看:浅谈 Java XML 底层解析方式 Jdom 你细看内部代码,

Atitit.操作注册表 树形数据库 注册表的历史 java版本类库总结

Atitit.操作注册表 树形数据库 注册表的历史 java版本类库总结 1. 注册表是树形数据库 1 2. 注册表的由来 1 3. Java  操作注册表 2 3.1. 使用Preferences API (限定访问路径了) 2 3.2. 使用JNI 3 3.3. Jregistrykey 推荐 4 3.4. Jregistry 4 4. org.openqa.selenium.os.WindowsUtils 4 4.1. 以及进程管理 4 1. 注册表是树形数据库 树形数据库,但不提供类似S