如何使用和开发自定义配置节
在日常的程序设计中,如何灵活和巧妙地运用配置信息是一个成功的设计师的首要选择。这不仅是为了程序设计得更灵活性和可扩展性,也是为了让你的代码给人以清新的感觉。程序中的配置信息一般放在应用程序的app.config或web.config文件中,当然也可以自定义自己的配置文件。这些配置文件是以XML格式进行存储和读取的。微软也封装一些对这些配置文件操作的类,这些类存在于名字空间System.Configuration下,这个命名空间包含提供用于处理配置数据的编程模型的类型,当然为了使用还添加System.Configuration.dll程序集。
现在我们先看一下这个名字空间下的几个重要的类:
1、ConfigurationManager,这个提供用于打开客户端应用程序集的Configuration对象。
2、WebConfigurationMaManager,这个提供用于打开web应用程序集的Configuration对象。
3、ConfigurationSection ,表示配置文件中的节。
4、ConfigurationSectionCollection ,表示配置文件中相关节的集合。
5、ConfigurationSectionGroup ,表示配置文件中的一组相关节。
6、ConfigurationSectionGroupCollection ,表示 ConfigurationSectionGroup 对象的集合。
7、ConfigurationProperty ,表示属性或配置元素的子元素。
8、ConfigurationPropertyAttribute ,以声明方式指示 .NET Framework,以实例化配置属性。
9、ConfigurationElement ,表示配置文件中的配置元素。
10、ConfigurationElementCollection ,表示包含一个子元素集合的配置元素。
当然这里面这常用的是ConfigurationManager类,这个类提供了两个静态常用的静态方法:
object GetSection(string sectionName)用于读取当前应用程序默认配置的指定配置信息;
Configuration OpenExeConfiguration(ConfigurationUserLevel userLevel)将当前应用程序配置文件打开以得到一个Configuration对象。
以及两个静态属性:AppSettins获取当前应用程序默认配置的AppSettingsSection数据;ConnectionStrings获取当前应用程序默认配置的ConnectionStringSection数据。
当然由于AppSettings是一个NameValueCollection对象,因此对它的读取和设置可以直接以AppSettings[“mySet”]的形式得到,相应的在*.config文件中的<appsettings>节下添加<add name=”mySet” value=””/>即可。
要自定义配置节配置元素,就必须要使我们的类分别继承自ConfigurationSection和ConfigurationElement类。那么实现这个两个类的对象就可以加入到配置文件的<configSection>和其他元素节点中。
这儿介绍在配置节点中加入自定义配置信息的能力(元素节点)。
1、实现一个继承自ConfigurationElement和ConfigurationSection的类,并添加的配置属性加上ConfigurationPropertyAttribute特性。
2、添加配置信息。
3、在程序中读取配置信息。
第一步:实现派生自ConfigurationSection和ConfigurationElement的类 |
using System; namespace MyCustomConfiguration //自定义配置节 } [ConfigurationProperty("value1", DefaultValue = "", IsRequired = true)] [ConfigurationProperty("value2", DefaultValue = "", IsRequired = true)] } |
第二步:在*.config中设置自定的元素 |
<configuration> <!-- 配置节--> MyCustomConfiguration.CustomSectionConfiguration, MyCustomConfiguration, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" allowLocation="true" allowDefinition="everywhere" /> …… …… </configuration> |
第三步:在程序中使用配置信息。 |
首先得到配置节对象: MyCustomConfiguration.CustomSectionConfiguration config = (MyCustomConfiguration.CustomSectionConfiguration)System.Configuration.ConfigurationManager.GetSection( |
上面介绍的是单一属性的配置,如果要配置多个对象,那么就得使用System.Configuration.ConfigurationElementCollection,这类的作用是生成多个子对象,也就是在一个标签下可以放置多个System.Configuration.ConfigurationElement对象。
方法同上,我们必须要重写几方法:
ConfigurationElement CreateNewElement()//这个方法的作用是返回子对象实例;
object GetElementKey(ConfigurationElement element);//这个方法的得到对象中的键名;
ConfigurationElementCollectionType CollectionType{get;}//这个属性是定义映射方式;
string ElementName{get;}//这个属性是定义XML元素的名字。
protected override ConfigurationElement CreateNewElement()
{
return new CustomElementConfiguration ();
}
protected override object GetElementKey(ConfigurationElement element)
{
return ((CustomElementConfiguration )element).Name;
}
public override ConfigurationElementCollectionType CollectionType
{
get { return ConfigurationElementCollectionType.BasicMap; }
}
protected override string ElementName
{
get { return "collection"; }
}