由Duwamish学习web.config的配置

Web.config

[UpDate@]2004.10.31

(1)各个标记名的命名规则：
标记名和属性名是 Camel 大小写形式的，这意味着标记名的第一个字符是小写的，任何后面连接单词的第一个字母是大写的。属性值是 Pascal 大小写形式的，这意味着第一个字符是大写的，任何后面连接单词的第一个字母也是大写的。true 和 false 例外，它们总是小写的。

(2)配置层次总图

所有配置信息都驻留在 <configuration> 和 </configuration> 根 XML 标记之间。
标记间的配置信息分为两个主区域：配置节处理程序声明区域和配置节设置区域。

<? xml version="1.0" ?>   <!--  可以不要  -->
< configuration >
<!--  ============= 1 =============================== ! -->
<!--  配置节处理程序声明区域(必须放在本节点的最上)  -->
  < configSections >

<section name="appSettings" type="System.Configuration.NameValueFileSectionHandler, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>

<!-- 这个section没有放到任何命名空间分组里面  -->
   < sectionGroup  name ="system.web" >   <!--  按照命名空间分组  -->
             < section  name ="authorization"  
                type ="System.Web.Configuration.AuthorizationConfigHandler, 
                System.Web, Version=1.0.3300.0, Culture=neutral, 
                PublicKeyToken=b03f5f7f11d50a3a" />             
             < section  name ="sessionState"  
               type ="System.Web.SessionState.SessionStateSectionHandler,
                System.Web, Version=1.0.3300.0, Culture=neutral,
                PublicKeyToken=b03f5f7f11d50a3a"
                allowDefinition ="MachineToApplication" />         
          </ sectionGroup >

  </ configSections >
<!--  ========= /1 ========================  -->
<!--  =========  2 ========================   -->
<!--   配置节设置区域  -->
<!--   如果没有上面的配置节处理程序声明区域，但默认继承了mechine.config，所以，我们在配置<authorization>等节点的
的时候，还是要加上它的组名称<system.web>
   -->
< system .web >
         < authorization >
             < allow  users ="*" />   <!--  Allow all users  -->
             <!--  Allow or deny specific users.
            allow users="[comma separated list of users]"
                  roles="[comma separated list of roles]"/>
            <deny users="[comma separated list of users]"
                  roles="[comma separated list of roles]"/>
             -->
         </ authorization >
         < sessionState 
             sqlConnectionString ="data source=localhost;
               Integrated Security=SSPI;
               Initial Catalog=northwind"
            cookieless ="false"  
            timeout ="10" />
  </ system.web >
<!--  mechine.config没有分组的节点名称有：
runtime
mscorlib
startup
system.runtime.remoting
system.diagnostics
appSettings
所以他们在配置的时候就少了一个层次.
-->
<!--  ================ /2 =========================   -->
</ configruation >

(3)配置原理

Example:

在配置节处理程序声明
<section name="appSettings" type="System.Configuration.NameValueFileSectionHandler, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
这个Section的name属性表示我们要在下面的配置节设置区域对应的名称.
type属性由指定的类来处理读取配置节设置区域的字段,其实这个type也定义了我们在配置节设置区域的配置格式.我们姑且把这种格式成为 名称/值对.

就这个type而言,上面例子的配置设置格式是:
<appSettings>
 <add key="name" value="caca"/>
 <add key="email" value="licunqing@gmail.com"/>
</appSettings>

我们可以这样读取key的value
string myname=System.Configuration.ConfigurationSettings.AppSettings["name"];
也可以读取所有的key的value返回一个集合
NameValueCollection config=(NameValueCollection)System.Configuration.ConfigurationSettings.GetConfig["appSettings"];
string myname=config["name"];
string myemail=config["email"];

所以，我们可以建立自己的type,至于相应的配置节设置区域的格式,我们这里还用System.Configuration.NameValueFileSectionHandler的形式.
来看看duwamish中的的例子
其配置节声明区域有一个自定义的Type类型:
<section name="DuwamishConfiguration" type=" Duwamish7.Common.DuwamishConfiguration, Duwamish7.Common" />

其相应的配置节声明格式为:

 <DuwamishConfiguration>
        <!-- Settings specific to the Duwamish application -->

        <add key="Duwamish.Web.EnablePageCache" value="True"/>
......
<DuwamishConfiguration>

显然这种配置节设置格式就是上面提到的 名称/值对的格式.

看来这个Section其本质的type类型还是System.Configuration.NameValueFileSectionHandler.

看看 Duwamish7.Common.DuwamishConfiguration

  public   class  DuwamishConfiguration : IConfigurationSectionHandler
{
 //这里简化了原代码
 public Object Create(Object parent, object configContext, XmlNode section)
        {
            
            NameValueCollection settings;

         NameValueSectionHandler baseHandler = new NameValueSectionHandler();
                settings = (NameValueCollection)baseHandler.Create(parent, configContext, section);

            return settings;
        }

}

确实,其本质就是NameValueSectionHandler,Duwamish7.Common.DuwamishConfiguration调用它,返回调用它的结果而已.
但是，我们这里可以加一些自己的东西，从而很好的控制它，比如在Duwamish中，实现如果节点配置域没有设置那些key 以及对应的value，就让他返回一个默认值。（参见Duwamish7.Common.DuwamishConfiguration)

 

[增加修改中......]
===========
参考：
全部信息请search MSDN：ASP.NET 配置系统 / 配置文件架构
另外看看Duwamish的源代码
http://www.microsoft.com/china/community/program/originalarticles/TechDoc/duwamish_con.mspx