君子博学而日参省乎己 则知明而行无过矣

博客园 首页 新随笔 联系 订阅 管理
ASP.NET杂谈-一切都从web.config说起（2）（ConfigSections详解-上 ）

ConfigSections的结构

首先我们先回顾一下ConfigSections的结构和它子节点的说明，如下:

   1:  <configSections>
   2:        <sectionGroup name="system.web.extensions" type="System.Web.Configuration.SystemWebExtensionsSectionGroup, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35">
   3:          <sectionGroup name="scripting" type="System.Web.Configuration.ScriptingSectionGroup, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35">
   4:            <section name="scriptResourceHandler" type="System.Web.Configuration.ScriptingScriptResourceHandlerSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" 
   5:                     requirePermission="false" allowDefinition="MachineToApplication"/>
   6:            <sectionGroup name="webServices" type="System.Web.Configuration.ScriptingWebServicesSectionGroup, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35">
   7:              <section name="jsonSerialization" type="System.Web.Configuration.ScriptingJsonSerializationSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" 
   8:                       requirePermission="false" allowDefinition="Everywhere" />
   9:              <section name="profileService" type="System.Web.Configuration.ScriptingProfileServiceSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" 
  10:                       requirePermission="false" allowDefinition="MachineToApplication" />
  11:              <section name="authenticationService" type="System.Web.Configuration.ScriptingAuthenticationServiceSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" 
  12:                       requirePermission="false" allowDefinition="MachineToApplication" />
  13:              <section name="roleService" type="System.Web.Configuration.ScriptingRoleServiceSection, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" 
  14:                       requirePermission="false" allowDefinition="MachineToApplication" />
  15:            </sectionGroup>
  16:          </sectionGroup>
  17:        </sectionGroup>
  18:      </configSections>
.csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas,"Courier New",courier,monospace; background-color: #ffffff; }.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; }.csharpcode .lnum { color: #606060; }

 

ConfigSectins属性和子节点说明    

属性：

    无。

子节点说明：

节点名称

功能描述

sectionGroup

定义配置节处理程序与配置节之间的关联。

section

定义配置节处理程序与配置元素之间的关联。

我们不难发现ConfigSectings主要包含SectiongGroup和Section两个子节点，下面就介绍一下这两个节点的属性说明：

1、sectionGroup属性说明

 

属性名称

功能描述

name

指定与下面 type 属性指定的配置节处理程序关联的配置节或元素的名称。

type

指定用来执行如下操作的配置节处理程序类的名称：处理在 name 属性中指定的节或元素中的配置设置。使用以下格式：

type=" Fully qualified class name , assembly file name , version , culture , public key token "，定义必须匹配程序集引用。

程序集文件必须与定义它的 Web.config 文件位于同一个应用程序目录中。

SectionGroup中还是可以在包含多个SectionGroup和Section。

 

 

2、section属性说明

属性名称

功能描述

name

 指定与 type 属性中指定的配置节处理程序关联的配置节或元素的名称。

type

 指定用来执行如下操作的配置节处理程序类的名称：处理在 name 属性中指定的节或元素中的配置设置，格式和上面sectionGroup属性中的type格式相同。

requirePermission

 指定是否得到相关的配置部分要求存取权限信息。可选的 Boolean 属性。

restartOnExternalChanges

指定在该节的配置数据发生更改时是否应当重新启动应用程序，不适用于 ASP.NET 应用程序，可选的 Boolean 属性。

allowLocation

指定是否可以在 location 元素内使用该节，仅适用于 ASP.NET 应用程序，默认值为 True。

allowExeDefinition

指定可以在哪个配置文件中使用该节，仅适用于 .NET Framework 客户端应用程序，可选的 Boolean 属性。

allowDefinition

指定可以在哪个配置文件中使用该节，仅适用于 ASP.NET 应用程序，可选的 Boolean 属性。

其实在配置allowDefinition和allowExeDefinition属性的时候，他们其实是有选择值的。allowDefinition的值是在ConfigurationAllowDefinition 枚举中选择，

而allowExeDefinition的值是在ConfigurationAllowExeDefinition 枚举中选择。下面就介绍一下这两个枚举中各个值的的介绍：

1、ConfigurationAllowDefinition 枚举

值

描述

Everywhere

允许在任何配置文件或目录中配置该节，如下所示：

  • Machine.config。

  • 根 Web.config。

  • 应用程序的 Web.config。

  • 虚拟目录。

  • 应用程序中的物理子目录。

如果未使用 allowDefinition 属性，则假设为 Everywhere。这是默认设置。

MachineToApplication

允许在下列文件之一中配置该节：

  • Machine.config。

  • 根 Web.config。

  • 应用程序的 Web.config。

这不包括位于应用程序中的虚拟目录或物理子目录下的 Web.config 文件。

MachineToWebRoot

允许在下列文件之一中配置该节：

  • Machine.config。

  • 根 Web.config。

MachineOnly

只允许在 Machine.config 文件中配置该节。

注释：

      Machine.config的位置：%SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG 中。

      根 Web.config的位置：%SystemRoot%\Microsoft.NET\Framework\versionNumber\CONFIG 中。

2、ConfigurationAllowExeDefinition 枚举

值

描述

MachineToApplication

可在 Machine.config 文件或客户端应用程序目录中的 Exe.config 文件中定义 ConfigurationSection。

MachineToRoamingUser

可在 Machine.config 文件、客户端应用程序目录中的 Exe.config 文件、漫游用户目录中的 User.config 文件或本地用户目录中的 User.config 文件中定义 ConfigurationSection。

MachineToLocalUser

可在 Machine.config 文件、客户端应用程序目录中的 Exe.config 文件或漫游用户目录中的 User.config 文件中定义 ConfigurationSection。

MachineOnly

ConfigurationSection 只能在 Machine.config 文件中定义。

举例说明

上面介绍了这么多，下面就用两个简单的Demo程序来介绍一下他们的具体应用吧：

1、Demo01介绍section的应用。

2、Demo02介绍包括子元素section的应用。

Demo01介绍一个配置用户信息的Section：

以下代码是Section的结构和属性的定义。

   1:  using System;
   2:  using System.Collections.Generic;
   3:  using System.Linq;
   4:  using System.Text;
   5:   
   6:  using System.Configuration;
   7:   
   8:  namespace KevinDiao.MySectionDemo01
   9:  {
  10:      /// <summary>
  11:      /// 自定义Section的结构
  12:      /// </summary>
  13:      public class MySection:ConfigurationSection
  14:      {
  15:          /// <summary>
  16:          /// 用户名称
  17:          /// </summary>
  18:          [ConfigurationProperty("username",IsRequired=true)]
  19:          public string UserName
  20:          {
  21:              get
  22:              {
  23:                  return (string)this["username"];
  24:              }
  25:              set
  26:              {
  27:                  this["username"] = value;
  28:              }
  29:          }
  30:          /// <summary>
  31:          /// 用户密码
  32:          /// </summary>
  33:          [ConfigurationProperty("password", IsRequired = true)]
  34:          public string Password
  35:          {
  36:              get
  37:              {
  38:                  return (string)this["password"];
  39:              }
  40:              set
  41:              {
  42:                  this["password"] = value;
  43:              }
  44:          }
  45:      }
  46:  }
.csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas,"Courier New",courier,monospace; background-color: #ffffff; }.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; }.csharpcode .lnum { color: #606060; }

下面介绍时简单的获取程序：

   1:  using System;
   2:  using System.Collections.Generic;
   3:  using System.Linq;
   4:  using System.Web;
   5:  using System.Web.UI;
   6:  using System.Web.UI.WebControls;
   7:   
   8:  using System.Configuration;
   9:  using KevinDiao.MySectionDemo01;
  10:   
  11:  namespace KevinDiao.AspNetDemo01
  12:  {
  13:      public partial class _Default : System.Web.UI.Page
  14:      {
  15:          protected void Page_Load(object sender, EventArgs e)
  16:          {
  17:              MySection mySection = (MySection)ConfigurationManager.GetSection("MySectionHandle01");
  18:              Response.Write("UserName:"+mySection.UserName+"<br/>");
  19:              Response.Write("Password:"+mySection .Password);
  20:          }
  21:      }
  22:  }
.csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas,"Courier New",courier,monospace; background-color: #ffffff; }.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; }.csharpcode .lnum { color: #606060; }

web.config中的配置信息

   1:  <configSections>
   2:    <section name="MySectionHandle01"    type="KevinDiao.MySectionDemo01.MySection,KevinDiao.MySectionDemo01"/>
   3:   </configSections>
   4:   <MySectionHandle01 username="kevindiao" password="123456"></MySectionHandle01>

.csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas,"Courier New",courier,monospace; background-color: #ffffff; }.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; }.csharpcode .lnum { color: #606060; }

获取到的结果：

UserName:kevindiao
Password:123456
.csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas,"Courier New",courier,monospace; background-color: #ffffff; }.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; }.csharpcode .lnum { color: #606060; }

Demo02还是用用户信息来举例吧，以下是具有的代码：

以下是自定义Section的结构：

   1:  using System;
   2:  using System.Collections.Generic;
   3:  using System.Linq;
   4:  using System.Text;
   5:   
   6:  using System.Configuration;
   7:   
   8:  namespace KevinDiao.MySectionDemo02
   9:  {
  10:      /// <summary>
  11:      /// 自定义Section
  12:      /// </summary>
  13:      public class MySectionHandle:ConfigurationSection
  14:      {
  15:          [ConfigurationProperty("users",IsRequired=true)]
  16:          public MySectionElement Users
  17:          {
  18:              get
  19:              {
  20:                  return (MySectionElement)this["users"];
  21:              }
  22:          }
  23:      }
  24:  }
.csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas,"Courier New",courier,monospace; background-color: #ffffff; }.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; }.csharpcode .lnum { color: #606060; }

自定义Element：

   1:  using System;
   2:  using System.Collections.Generic;
   3:  using System.Linq;
   4:  using System.Text;
   5:   
   6:  using System.Configuration;
   7:   
   8:  namespace KevinDiao.MySectionDemo02
   9:  {
  10:      /// <summary>
  11:      /// 自定义Element
  12:      /// </summary>
  13:      public class MySectionElement : ConfigurationElement
  14:      {
  15:          /// <summary>
  16:          /// 用户名
  17:          /// </summary>
  18:          [ConfigurationProperty("username", IsRequired = true)]
  19:          public string UserName
  20:          {
  21:              get
  22:              {
  23:                  return (string)this["username"];
  24:              }
  25:          }
  26:          /// <summary>
  27:          /// 密码
  28:          /// </summary>
  29:          [ConfigurationProperty("password", IsRequired = true)]
  30:          public string Password
  31:          {
  32:              get
  33:              {
  34:                  return (string)this["password"];
  35:              }
  36:          }
  37:      }
  38:  }
.csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas,"Courier New",courier,monospace; background-color: #ffffff; }.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; }.csharpcode .lnum { color: #606060; }

读取页面：

   1:  using System;
   2:  using System.Collections.Generic;
   3:  using System.Linq;
   4:  using System.Web;
   5:  using System.Web.UI;
   6:  using System.Web.UI.WebControls;
   7:   
   8:  using System.Configuration;
   9:  using KevinDiao.MySectionDemo01;
  10:  using KevinDiao.MySectionDemo02;
  11:   
  12:  namespace KevinDiao.AspNetDemo01
  13:  {
  14:      public partial class _Default : System.Web.UI.Page
  15:      {
  16:          protected void Page_Load(object sender, EventArgs e)
  17:          {
  18:             
  19:   
  20:              MySectionHandle mySectionHandle = (MySectionHandle)ConfigurationManager.GetSection("MySectionHandle02");
  21:              Response.Write("username："+mySectionHandle .Users .UserName+"<br/>");
  22:              Response.Write("password：" + mySectionHandle.Users.Password + "<br/>");
  23:   
  24:          }
  25:      }
  26:  }
.csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas,"Courier New",courier,monospace; background-color: #ffffff; }.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; }.csharpcode .lnum { color: #606060; }

web.config中的配置信息

   1:  <configSections>
   2:      <section name ="MySectionHandle02" type="KevinDiao.MySectionDemo02.MySectionHandle,KevinDiao.MySectionDemo02"/>
   3:     </configSections>
   4:   
   5:    <MySectionHandle02>
   6:      <users username="kevin" password="123"></users>
   7:    </MySectionHandle02>
.csharpcode, .csharpcode pre { font-size: small; color: black; font-family: consolas,"Courier New",courier,monospace; background-color: #ffffff; }.csharpcode pre { margin: 0em; }.csharpcode .rem { color: #008000; }.csharpcode .kwrd { color: #0000ff; }.csharpcode .str { color: #006080; }.csharpcode .op { color: #0000c0; }.csharpcode .preproc { color: #cc6633; }.csharpcode .asp { background-color: #ffff00; }.csharpcode .html { color: #800000; }.csharpcode .attr { color: #ff0000; }.csharpcode .alt { background-color: #f4f4f4; width: 100%; margin: 0em; }.csharpcode .lnum { color: #606060; }

获取的的结果：

username：kevin
password：123

今晚就先到这里了，下一篇我们在讨论一下SectionGroup、SectionCollection等的应用，最后在介绍个案例，加深大家的理解和在具体的项目中的应用。

 

参考：

         MSDN

posted on 2011-04-07 01:32  刺猬的温驯  阅读(119)  评论(0)  编辑  收藏  举报