.Net 更容易的使用配置文件 SuperConfig

一、原始配置文件的问题

我们在做开发时，不管是B/S还是C/S，现在几乎所有的项目都会碰到使用配置文件，简单点的如链接字符串、上传路径啊，一些API的接口地址等等。复杂点就更多了，如ActiveMQ的配置信息（地址、端口、用户名、密码）等等。

在.Net开发中已经在（Web.config/App.config）中提供了相对完善的配置系统，简单的如：appSettings；复杂的如：section；相信大家一定用过，当然使用配置文件第一步先添加引用：“System.Configuration”;

1. appSettings使用 System.Configuration.ConfigurationManager.AppSettings[name]即可获取单个的配置项，可以说非常简单方便。
2. section很多人也许很陌生，但是在开发中也许都碰到过，比如在使用EntityFramework时，会在configSections中添加一项section name为entityFramework一项配置。当然肯定可以自定义section，但在使用配置文件的section相对比较复杂，而且数据类型支持的很有限，代码过多等原因。在实际开发中LZ比较少用section，实在配置项过多逼不得已才会使用section。
   

如上所说，在配置文件中碰到需要配置很多项时，原始配置文件存在着诸多不便，本篇就是告诉大家怎么在配置多项时更加容易的使用配置文件。

二、思路和解决办法

a)、思路

1. 最好沿用原始的配置方法，也就是使用section，这样可以不用指定配置文件位置，名称等等。当然如果需要单独的配置文件，或者不用section模式也可以随意的扩展。再或者知道xml格式的字符串也可以获取配置，如配置在数据库中等。
2. 需要新建一个类，其中包括我们需要配置的信息，也就是一些属性，当然最好不需要继承父类或者实现接口。
3. 需要配置配置文件，当然是按照新建类的格式配置，数据类型简单的需要支持Int、String、double、Enum、Datetime等，复杂的最好支持：KeyValuePair、Array、List、Dictionary等。
4. 最好一行代码使用泛型可以获取具体的配置信息，如var config=Xxxx<T>.Value;

b)、解决办法

目前在网上LZ并没有找到在.Net中更好的使用配置文件，所以LZ无奈自己写了一个，可以实现我所说的“思路”，并MIT开源放置Github上，供大家交流学习，而且上传至Nuget，方便大家使用。

三、Emrys.SuperConfig

Github：https://github.com/Emrys5/Emrys.SuperConfig  欢迎大家Star ^_^

Nuget：https://www.nuget.org/packages/Emrys.SuperConfig

Wiki：https://github.com/Emrys5/Emrys.SuperConfig/wiki

四、Emrys.SuperConfig 简单应用

1. 安装包 Emrys.SuperConfig
   

   PM>Install-Package Emrys.SuperConfig

2. 新建类 UserInfo

   class UserInfo
   {
       public string UserName { get; set; }
       public string Email { get; set; }
       public int Age { get; set; }
       public string BlogUrl { get; set; }
       public Color FavoriteColor { get; set; }
       public Color DislikeColor { get; set; } 
       public List<string> Language { get; set; }
      
   }
   enum Color{Red,Blue,Black} 

3. 在web.config或者app.config中配置配置文件
   

   <?xml version="1.0" encoding="utf-8" ?>
   <configuration>
     <configSections>
       <section name="userInfo" type="Emrys.SuperConfig.Section,Emrys.SuperConfig"></section>
     </configSections>
     <userInfo userName="Emrys" email="i@emrys.me" age="27">
       <blogUrl>http://www.cnblogs.com/emrys5/</blogUrl>
       <favoriteColor>Blue</favoriteColor>
       <dislikeColor>2</dislikeColor> 
       <language>
         <value>Putonghua</value>
         <value>Huaipu</value>
         <value>English</value>
       </language> 
     </userInfo> 
   </configuration> 

4.  获取配置文件信息

    var user = SuperConfig<UserInfo>.Value;

只需要一行代码就可以获取所有的配置信息，可以用简单方便易用来形容。

四、Emrys.SuperConfig 其他

1、支持的数据类型

普通的数据类型支持 String、Int、Double、DateTime、Bool、Enum等，这些都是比较简单的数据类型直接使用即可。

更多复杂的类型如KeyValuePair/Array/List/Dictionary等请参看Wiki：支持数据类型

2、自定义配置文件位置

在实际开发中，我们也许不把配置文件放置默认的Web.config/App.config，如单独配置用户的信息等等

更多请参看Wiki：自定义配置文件位置

3、自定义配置文件命名规则

在开发中，有很多人程序员的命名规则不是很统一，所有就会出现名称大小写的问题，其中命名包含xml的element和Attribute的名称。

SuperConfig默认采用的首字母小写，也就是小驼峰。

更多请参看Wiki：自定义配置文件命名规则

4、自定义Section格式

在原始的配置文件中，我们需要自定义配置文件，那么就需要在配置文件中配置section，如我们常见的EntityFramework。

如果我们自定义配置文件位置，也就说不用原始的配置文件，那么我们也就没必要按照之前的配置方法每次在configSections新建一个Section，然后在配置。

我们完全可以自定义自己的配置文件格式，如：

<?xml version="1.0" encoding="utf-8" ?> 
<config>
  <userInfo userName="CEmrys" email="i@emrys.me" age="17">
    <blogUrl>http://www.cnblogs.com/emrys5/</blogUrl>
    <favoriteColor>Blue</favoriteColor>
    <dislikeColor>2</dislikeColor>
  </userInfo>
  <arrayString>
    <item>a</item>
    <item>b</item>
    <item>c</item>
    <item>d</item>
    <item>e</item>
  </arrayString>
</config>

更多请参看Wiki：自定义Section格式

五、总结

LZ鉴于不够方便的在.Net中使用配置文件和在网上没有找到合适的方法，所有自己按照自己的想法写了一个，希望对大家也有所帮助。

最后别忘记了“推荐”和Github Star 谢谢！

Github：https://github.com/Emrys5/Emrys.SuperConfig  欢迎大家Star ^_^

Nuget：https://www.nuget.org/packages/Emrys.SuperConfig

Wiki：https://github.com/Emrys5/Emrys.SuperConfig/wiki