在Web.config或App.config中的添加自定义配置 <转>

.Net中的System.Configuration命名空间为我们在web.config或者app.config中自定义配置提供了完美的支持。最近看到一些项目中还在自定义xml文件做程序的配置,所以忍不住写一篇用系统自定义配置的随笔了。
如果你已经对自定义配置了如指掌,请忽略这篇文章。
言归正传,我们先来看一个最简单的自定义配置
<? xml version="1.0" encoding="utf-8" ?> < configuration > < configSections > < section name="simple" type="ConfigExample.Configuration.SimpleSection,ConfigExample"/> </ configSections > < simple maxValue="20" minValue="1"></ simple > </ configuration > |
在配置文件中使用自定义配置,需要在configSections中添加一个section元素,并制定此section元素对应的类型和名字。然后再在configuration根节点下面添加此自定义配置,如上例中的simple节点。simple节点只有两个整形数的属性maxValue和minValue。
要在程序中使用自定义配置我们还需要实现存取这个配置块的类型,一般需要做如下三件事:
1. 定义类型从System.Configuration.ConfigurationSection继承
2. 定义配置类的属性,这些属性需要用ConfigurationProperty特性修饰,并制定属性在配置节中的名称和其他一些限制信息
3. 通过基类的string索引器实现属性的get ,set
非常简单和自然,如下是上面配置类的实现:
public class SimpleSection:System.Configuration.ConfigurationSection { [ConfigurationProperty( "maxValue" ,IsRequired= false ,DefaultValue=Int32.MaxValue)] public int MaxValue { get { return ( int ) base [ "maxValue" ]; } set { base [ "maxValue" ] = value; } } [ConfigurationProperty( "minValue" ,IsRequired= false ,DefaultValue=1)] public int MinValue { get { return ( int ) base [ "minValue" ];} set { base [ "minValue" ] = value; } } [ConfigurationProperty( "enabled" ,IsRequired= false ,DefaultValue= true )] public bool Enable { get { return ( bool ) base [ "enabled" ]; } set { base [ "enabled" ] = value; } } } |
这样子一个简单的配置类就完成了,怎么在程序中使用这个配置呢?需要使用ConfigurationManager类(要引用System.configuration.dll这个dll只有在.Net2.0之后的版本中才有)的GetSection方法获得配置就可以了。如下代码:
SimpleSection simple = ConfigurationManager.GetSection( "simple" ) as SimpleSection; Console.WriteLine( "simple minValue={0} maxValue = {1}" ,simple.MinValue,simple.MaxValue); |
这个配置类太过简陋了,可能有时候我们还需要更复杂的构造,比如在配置类中使用类表示一组数据,下面我们看一个稍微复杂一点的自定义配置
<? xml version="1.0" encoding="utf-8" ?> < configuration > < configSections > < section name="complex" type="ConfigExample.Configuration.ComplexSection,ConfigExample"/> </ configSections > < complex height="190"> < child firstName="James" lastName="Bond"/> </ complex > </ configuration > |
这个配置的名字是complex,他有一个属性height,他的节点内还有一个child元素这个元素有两个属性firstName和lastName;对于这个内嵌的节点该如何实现呢?首先我们需要定义一个类,要从ConfigurationElement类继承,然后再用和SimpleSection类似的方法定义一些用ConfigurationProperty特性修饰的属性就可以了,当然属性值的get,set也要使用基类的索引器。如下实现:
public class ComplexSection : ConfigurationSection { [ConfigurationProperty( "height" , IsRequired = true )] public int Height { get { return ( int ) base [ "height" ]; } set { base [ "height" ] = value; } } [ConfigurationProperty( "child" , IsDefaultCollection = false )] public ChildSection Child { get { return (ChildSection) base [ "child" ]; } set { base [ "child" ] = value; } } } public class ChildSection : ConfigurationElement { [ConfigurationProperty( "firstName" , IsRequired = true , IsKey = true )] public string FirstName { get { return ( string ) base [ "firstName" ]; } set { base [ "firstName" ] = value; } } [ConfigurationProperty( "lastName" , IsRequired = true )] public string LastName { get { return ( string ) base [ "lastName" ]; } set { base [ "lastName" ] = value; } } } |
还有稍微再复杂一点的情况,我们可能要在配置中配置一组相同类型的节点,也就是一组节点的集合。如下面的配置:
<? xml version="1.0" encoding="utf-8" ?> < configuration > < configSections > < section name="complex" type="ConfigExample.Configuration.ComplexSection,ConfigExample"/> </ configSections > < complex height="190"> < child firstName="James" lastName="Bond"/> < children > < add firstName="Zhao" lastName="yukai"/> < add firstName="Lee" lastName="yukai"/> < remove firstName="Zhao"/> </ children > </ complex > </ configuration > |
请看children节点,它就是一个集合类,在它里面定义了一组add元素,也可以有remove节点把已经添进去的配置去掉。
要使用自定义节点集合需要从ConfigurationElementCollection类继承一个自定义类,然后要实现此类GetElementKey(ConfigurationElement element)和ConfigurationElement CreateNewElement()两个方法;为了方便的访问子节点可以在这个类里面定义只读的索引器。请看下面的实现
public class Children : ConfigurationElementCollection { protected override object GetElementKey(ConfigurationElement element) { return ((ChildSection)element).FirstName; } protected override ConfigurationElement CreateNewElement() { return new ChildSection(); } public ChildSection this [ int i] { get { return (ChildSection) base .BaseGet(i); } } public ChildSection this [ string key] { get { return (ChildSection) base .BaseGet(key); } } } |
当然要使用此集合类我们必须在Complex类中添加一个此集合类的属性,并要指定集合类的元素类型等属性,如下:
[ConfigurationProperty( "children" , IsDefaultCollection = false )] [ConfigurationCollection( typeof (ChildSection), CollectionType = ConfigurationElementCollectionType.AddRemoveClearMap, RemoveItemName = "remove" )] public Children Children { get { return (Children) base [ "children" ]; } set { base [ "children" ] = value; } } |
我们会经常用到类似appSettings配置节的键值对的构造,这时候我们就不必再自己实现了,我们可以直接使用现有的System.Configuration.NameValueConfigurationCollection类来定义一个自定义的键值对。可以在Complex类中定义如下属性
[ConfigurationProperty( "NVs" , IsDefaultCollection = false )] public System.Configuration.NameValueConfigurationCollection NVs { get { return (NameValueConfigurationCollection) base [ "NVs" ]; } set { base [ "NVs" ] = value; } } |
然后在配置文件的complex节中添加键值对配置
< NVs > < add name="abc" value="123"/> < add name="abcd" value="12d3"/> </ NVs > |
到这儿已经基本上可以满足所有的配置需求了。不过还有一点更大但是不复杂的概念,就是sectionGroup。我们可以自定义SectionGroup,然后在sectionGroup中配置多个section;分组对于大的应用程序是很有意义的。
如下配置,配置了一个包含simple和一个complex两个section的sectionGroup
<? xml version="1.0" encoding="utf-8" ?> < configuration > < configSections > < sectionGroup type="ConfigExample.Configuration.SampleSectionGroup,ConfigExample" name="sampleGroup"> < section type="ConfigExample.Configuration.SimpleSection,ConfigExample" allowDefinition="Everywhere" name="simple" /> < section type="ConfigExample.Configuration.ComplexSection,ConfigExample" allowDefinition="Everywhere" name="complex"/> </ sectionGroup > </ configSections > < sampleGroup > < simple maxValue="20" minValue="1"> </ simple > < complex height="190"> < child firstName="James" lastName="Bond"/> < children > < add firstName="Zhao" lastName="yukai"/> < add firstName="Lee" lastName="yukai"/> < remove firstName="Zhao"/> </ children > < NVs > < add name="abc" value="123"/> < add name="abcd" value="12d3"/> </ NVs > </ complex > </ sampleGroup > </ configuration > |
为了方便的存取sectionGroup中的section我们可以实现一个继承自System.Configuration.ConfigurationSectionGroup类的自定义类。实现很简单,就是通过基类的Sections[“sectionName”]索引器返回Section。如下:
public class SampleSectionGroup : System.Configuration.ConfigurationSectionGroup { public SimpleSection Simple { get { return (SimpleSection) base .Sections[ "simple" ]; } } public ComplexSection Complex { get { return (ComplexSection) base .Sections[ "complex" ]; } } } |
需要注意的是SectionGroup不能使用ConfigurationManager.GetSection(string)方法来获得,要获得sectionGroup必须通过Configuration类的SectionGroups[string]索引器获得,如下示例代码:
SampleSectionGroup sample = (SampleSectionGroup)ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None).SectionGroups[ "sampleGroup" ]; |
总结:
.Net framework给我们提供了一套很方便的配置库,我们只需要继承对应的类简单的配置一下就可以方便的使用在web.config或者app.config中配置的自定义节点了。
转自 http://www.cnblogs.com/yukaizhao/archive/2011/12/02/net-web-config-costom-config-implement.html
在Web.config或App.config中的添加自定义配置 <转>的更多相关文章
- 在Web.config或App.config中的添加自定义配置
.Net中的System.Configuration命名空间为我们在web.config或者app.config中自定义配置提供了完美的支持.最近看到一些项目中还在自定义xml文件做程序的配置,所以忍 ...
- 修改和获取web.config或app.config文件appSettings配置节中的Add里的value属性 函数
1: /// <summary> 2: /// 修改web.config或app.config文件appSettings配置节中的Add里的value属性 3: /// </summ ...
- 说说Web.Config与App.Config
说到web.config和app.config大家都很熟悉,我们都叫他们配置文件,平时用的多,注意的少.两个有啥区别呢,很简单,一句话:如果是web程序,如webform项目类型和mvc项目类型就是w ...
- 一个web.Config或app.Config自定义段configSections的示例
一个web.Config或app.Config自定义段configSections的示例 越来越觉得,直接用配置文件app.Config或web.Config配置应用系统的运行参数,比自己做一个xml ...
- 一个web.Config或app.Config自定义段configSections的示例--转
直接用配置文件app.Config或web.Config配置应用系统的运行参数,比自己做一个xml配置文件,简洁方便得多.这两个配置文件不仅有常见的connectionStrings和appSetti ...
- .NET下对Web.config与App.Config的增删改操作的代码
把代码过程常用的内容做个收藏,下边代码段是关于 .NET下对Web.config与App.Config的增删改操作的代码. <?xml version="1.0" encod ...
- .net分布在指定文件夹的web.confgi或者app.config
.Net里面,ConfigurationManager默认读取的是Web.config或者App.config但是,什么都放在这两个文件里面,感觉太多了,也不好管理配置.于是参考了下别人的资料,自己写 ...
- web.config or app.config 中configSections配置节点
以前还真没见过,今天看项目中有在用,简单写了个Demo,这样配置的好处就是可以自定义配置,更加模块化,直接上代码; 1.配置文件 由于我创建的是一个控制台项目,所以配置文件是App.Config:(这 ...
- 配置文件(Machine.config、Web.config、App.config)
Machine.config1.该文件在Windows目录下\Microsoft.net\framework\[version]\Config\2.为了提高性能,该文件只包含不同于默认值的设置.并且定 ...
随机推荐
- 2019swpuj2ee作业一:C/S,B/S的应用的区别
1.硬件环境不同: C/S 一般建立在专用的网络上, 小范围里的网络环境, 局域网之间再通过专门服务器提供连接和数据交换服务.B/S 建立在广域网之上的, 不必是专门的网络硬件环境,例与电话上网, ...
- 使用pwm进行呼吸灯的设计
本文源码已经上传至csdn: 程序源码如下; #define LEDC_IO_0 (2) esp_err_t app_main() { ledc_timer_config_t ledc_timer = ...
- bootstrap的化妆页面
Glyphicons 字体图标 所有可用的图标 包括260个来自 Glyphicon Halflings 的字体图标.Glyphi cons Halflings 一般是收费的,但是他们的作者允许 Bo ...
- ESB结合门户Portlet实现数据分析
1 背景概述 笔者在公司做集成项目时,通常会涉及ESB与Portal结合实现图表数据分析功能.通过ESB获取数据库信息,然后在门户上采用Portlet接收ESB中的数据URL最后展现到门户上.本文为项 ...
- Mac 视频录制然后转 gif
https://gist.github.com/dergachev/4627207 用 ScreenShot 或 Quicktime Player 录制视频, 保存位 in.mov ffmpeg -i ...
- 《Opencv 3 计算机视觉 python语言实现》· 第二遍 —— 读后笔记
概览 代码实战 https://github.com/xinghalo/ml-in-action/tree/master/book-opencv
- Java 10 实战第 1 篇:局部变量类型推断
现在 Java 9 被遗弃了直接升级到了 Java 10,之前也发过 Java 10 新特性的文章,现在是开始实战 Java 10 的时候了. 今天要实战的是 Java 10 中最重要的特性:局部变量 ...
- Spring Boot读取配置的 5 种方式
读取application文件 在application.yml或者properties文件中添加: info.address=USA info.company=Spring info.degree= ...
- Liferay7 BPM门户开发之19: 理解Service Builder体系
Service Builder是Liferay为业务开发而设计的模型驱动(model-driven)平台工具,提供一系列的实体类.数据持久化.服务相关的代码自动生成服务.支持Hibernate and ...
- javaweb目录结构简介
以上图说明: bbs目录代表一个web应用 bbs目录下的html,jsp文件可以直接被浏览器访问 WEB-INF目录下的资源是不能直接被浏览器访问的 web.xml文件是web程序的主要配置文件 所 ...