革新:.NET 2.0的自定义配置文件体系初探

本文详细介绍了在.NET 2.0环境中如何创建和使用自定义配置文件。通过示例展示了如何定义配置节类、配置属性及其实现细节,并提供了访问和修改配置文件的方法。
以前在1.1.的时代我们为了写一个自定义配置,需要实现System.Configuration.IConfigurationSectionHandler接口,然后用System.Configuration.ConfigurationSettings.AppSettings.Get()方法去获取配置内容。在实现System.Configuration.IConfigurationSectionHandler的过程中会进行大量繁琐的XML节操作,如果希望Get()方法返回一个强类型的配置实体对象,还需要写一个相应的类。这些工作枯燥而且工作量很大,特别是在一个配置很复杂的时候。
并且,1.1中的配置文件对于程序来说是只读的,若配置文件一旦发生改变怎会引发应用程序重启。

而现在,2.0提供了全新的自定义配置文件构建方式,支持强类型的配置属性,并提供了代码对配置文件进行动态修改的机制。我对其作了一些初步的研究,在这里抛砖引玉了。


  1. 首先我们来看看最简单的情况如何处理:

    <? xmlversion="1.0"encoding="utf-8" ?>
    < configuration >
    < configSections >
    < section name ="RemotingCompress" type ="Xrinehart.Framework.CommSupport.Section.RemotingCompressSection,ConfigManagement"
    allowDefinition
    ="Everywhere" allowExeDefinition ="MachineToApplication" restartOnExternalChanges ="true" />
    </ configSections >
    < RemotingCompress CompressLevel ="DEFAULT_COMPRESSION" CompressCacheSize ="1024" UnCompressCacheSize ="1024" MinCompressSize ="0" >
    </ configuration >

    只有一个配置节:RemotingCompress,拥有4个属性CompressLevel、CompressCacheSize、UnCompressCacheSize、MinCompressSize。

    我们需要实现一个从System.Configuration.ConfigurationSection基类继承的配置类,在2.0里配置信息实体和配置识别都在一个类中,我们先来看代码:
    using System;
    using System.Collections.Generic;
    using System.Text;
    using System.Configuration;

    namespace Xrinehart.Framework.CommSupport.Section
    {
    /**////<summary>
    ///压缩率级别的枚举
    ///</summary>

    publicenumDeflater
    {
    /**////<summary>
    ///最佳压缩效果,速度慢
    ///</summary>

    BEST_COMPRESSION=9,
    /**////<summary>
    ///默认压缩率,压缩速度比最高(推荐)
    ///</summary>

    DEFAULT_COMPRESSION=-1,
    /**////<summary>
    ///强化压缩率,速度较慢
    ///</summary>

    DEFLATED=8,
    /**////<summary>
    ///最佳速度压缩率,速度最快(宽带推荐)
    ///</summary>

    BEST_SPEED=1,
    /**////<summary>
    ///不压缩
    ///</summary>

    NO_COMPRESSION=0
    }
    ;

    /**////<summary>
    ///RemotingCompress配置节类
    ///</summary>

    publicsealedclassRemotingCompressSection:System.Configuration.ConfigurationSection
    {
    //该配置文件只读
    privatestaticbool_ReadOnly=true;

    publicRemotingCompressSection()
    {
    }


    privatenewboolIsReadOnly
    {
    get
    {
    return_ReadOnly;
    }

    }


    privatevoidThrowIfReadOnly(stringpropertyName)
    {
    if(IsReadOnly)
    thrownewConfigurationErrorsException(
    "Theproperty"+propertyName+"isreadonly.");
    }


    protectedoverrideobjectGetRuntimeObject()
    {
    //Toenablepropertysettingjustassigntrueto
    //thefollowingflag.
    _ReadOnly=true;
    returnbase.GetRuntimeObject();
    }


    所有配置属性#region所有配置属性

    /**////<summary>
    ///配置节属性:压缩率级别(可选)
    ///</summary>

    [ConfigurationProperty("CompressLevel",DefaultValue="DEFAULT_COMPRESSION",Options=ConfigurationPropertyOptions.None)]
    publicDeflaterCompressLevel
    {
    get
    {
    return(Deflater)this["CompressLevel"];
    }

    set
    {
    ThrowIfReadOnly(
    "CompressLevel");
    this["compressLevel"]=value;
    }

    }


    /**////<summary>
    ///配置节属性:压缩时缓冲区大小(可选)
    ///</summary>

    [ConfigurationProperty("CompressCacheSize",DefaultValue=(Int32)40960,Options=ConfigurationPropertyOptions.None)]
    [IntegerValidator(MinValue
    =1024,MaxValue=1024*1024,ExcludeRange=false)]
    publicintCompressCacheSize
    {
    get
    {
    return(Int32)this["CompressCacheSize"];
    }

    set
    {
    ThrowIfReadOnly(
    "CompressCacheSize");
    this["CompressCacheSize"]=value;
    }

    }


    /**////<summary>
    ///配置节属性:解压时缓冲区大小(可选)
    ///</summary>

    [ConfigurationProperty("UnCompressCacheSize",DefaultValue=(Int32)40960,Options=ConfigurationPropertyOptions.None)]
    [IntegerValidator(MinValue
    =1024,MaxValue=1024*1024,ExcludeRange=false)]
    publicintUnCompressCacheSize
    {
    get
    {
    return(Int32)this["UnCompressCacheSize"];
    }

    set
    {
    ThrowIfReadOnly(
    "UnCompressCacheSize");
    this["UnCompressCacheSize"]=value;
    }

    }


    /**////<summary>
    ///配置节属性:超过该值后的流才会被压缩(可选),暂未实现
    ///</summary>

    [ConfigurationProperty("MinCompressSize",DefaultValue=(Int32)40960,Options=ConfigurationPropertyOptions.None)]
    [IntegerValidator(MinValue
    =0,MaxValue=Int32.MaxValue,ExcludeRange=false)]
    publicintMinCompressSize
    {
    get
    {
    return(Int32)this["MinCompressSize"];
    }

    set
    {
    ThrowIfReadOnly(
    "MinCompressSize");
    this["MinCompressSize"]=value;
    }

    }

    #endregion

    }

    }



    上面的代码中可以看到核心代码是ConfigurationPropertyAttribute属性,在一个类属性上插入一个ConfigurationPropertyAttribute即可完成对配置文件中一个节点的属性的申明。

    比如CompressLevel这个属性的定义:
    /**/ ///<summary>
    ///配置节属性:压缩率级别(可选)
    ///</summary>

    [ConfigurationProperty( " CompressLevel " ,DefaultValue = " DEFAULT_COMPRESSION " ,Options = ConfigurationPropertyOptions.None)]
    public DeflaterCompressLevel
    {
    get
    {
    return(Deflater)this["CompressLevel"];
    }

    set
    {
    ThrowIfReadOnly(
    "CompressLevel");
    this["compressLevel"]=value;
    }

    }
    首先,ConfigurationProperty的第一个参数"CompressLevel"这个是在XML配置文件中属性的名字,注意它是大小写敏感的。而DefaultValue则是设置该属性的默认值,Options设置有4种,分别是None, IsKey, IsRequired, IsDefaultCollection.这四项也可以单独在属性里分别设置。
    若选择了None,则该属性可以在配置文件中不体现,而系统会去取得设置的默认值(如果有设置的话);若选择了IsRequired而在配置文件中没有体现,则会引发异常。另外,若所有一个配置节的所有属性都不是必须的,在配置文件中即便没有这个配置节,依然可以在系统中得到该配置节的默认值信息。

    请注意该属性是个枚举类型,而在属性中对类型进行转换,即可方便的实现,并不需要做其他更多的处理。

    你也许注意到在代码中的一些属性有[IntegerValidator(MinValue = 0, MaxValue = Int32.MaxValue, ExcludeRange = false)]这样的代码.是的,类库中提供了IntegerValidatorAttribute、LongValidatorAttribute、RegexStringValidatorAttribute、StringValidatorAttribute、TimeSpanValidatorAttribute默认的数据校验类,可以对XML中的该属性进行规范限制,并且你可以自己实现从ConfigurationValidatorAttribute基类继承的自定义校验类,完成一些自己设定的校验,比如对上述的枚举类型值的限制。


    接下来,我们看看如何访问到该配置节的。
    首先在配置文件中添加识别节点的信息,参见上面。然后我们需要用到System.Configuration.ConfigurationManager.OpenMappedExeConfiguration()方法。
    System.Configuration.Configurationconfig = ConfigurationManager.OpenExeConfiguration(ConfigurationUserLevel.None);

    RemotingCompressSectionsection
    = config. Sections[ " RemotingCompress " ] as RemotingCompressSection;
    OpenMappedExeConfiguration()有两种重载,我只尝试成功了上述这种,另外一种说是可以从指定配置文件中得到配置对象,但我没成功过,谁要是搞明白了,记得告诉我下。

    只需上面两行就可以做到,当然还可以更简单RemotingCompressSectionsection = ConfigurationManager.GetSection("RemotingCompress") as RemotingCompressSection。而我写上面这种写法是为了可以在运行时对配置文件内容进行修改。

    另外,若配置文件有配置节点组,即
    <? xmlversion="1.0"encoding="utf-8" ?>
    < configuration >
    < configSections >
    < sectionGroup name ="XrinehartFramework" >
    < sectionGroup name ="CommSupport" >
    < section name ="RemotingCompress" type ="Xrinehart.Framework.CommSupport.Section.RemotingCompressSection,ConfigManagement"
    allowDefinition
    ="Everywhere" allowExeDefinition ="MachineToApplication" restartOnExternalChanges ="true" />
    </ sectionGroup >
    </ sectionGroup >
    </ configSections >
    < XrinehartFramework >
    < CommSupport >
    < RemotingCompress CompressLevel ="DEFAULT_COMPRESSION" CompressCacheSize ="1024" UnCompressCacheSize ="1024" MinCompressSize ="0" >
    </ RemotingCompress >
    </ CommSupport >
    </ XrinehartFramework >
    </ configuration >
    你也只需要相应的改变下获取的代码,而不用去改变配置类
    config.SectionGroups["XrinehartFramework"].SectionGroups["CommSupport"].Sections["RemotingCompress"]
  2. 我们再来看看如何在代码中对配置节的内容进行修改:
    section.CompressLevel=Deflater.BEST_SPEED;
    config.Save();

    即在对配置对象的属性进行修改之后,用配置文件对象的save方法。你还可以用SaveAs方法存为别的文件。
  3. 这次就先讲那么多,下次再继续介绍更复杂的配置文件的处理方式,比如节点下有子节点的情况。如果你有什么发现也请告诉我。
另外刚发现编不错的文章。 http://blog.youkuaiyun.com/mixiaobo/archive/2005/11/18/532386.aspx
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值