DotText源码学习——从配置文件Web.config入手（一）

概述

ASP.NET配置数据存储在名为
Machine.config/Web.config的XML文本文件中，Web.config文件可以出现在ASP.NET应用程序的多个目录中。由于
这些文件将应用程序配置设置与应用程序代码分开，可以方便地设置与应用程序关联。正是因为配置文件中存储着关于整个应用程序的设置，当我读一个陌生项目的
源码时，经常把它作为入口。

我将从以下几点分析ASP.NET配置文件：

  1. ASP.NET配置文件的层次结构
  2. Machine.config和根Web.config配置文件
  3. ASP.NET配置文件的结构
  4. 自定义配置节及配置节处理程序
  5. 访问配置文件中的配置数据

1、ASP.NET配置文件的层次结构

ASP.NET配置文件完全是基于XML的，它们可以出现在ASP.NET应用程序的多个目录中。ASP.NET配置层次结构具有以下特征：

  • 使用应用于配置文件所在的目录及其所有子目录中的资源的配置文件。
  • 允许将配置数据放在将使它具有适当范围（整台计算机、所有的Web应用程序、单个应用程序或该应用程序中的子目录）的位置。
  • 允许重写从配置层次中的较高级别继承的配置设置。还允许锁定配置设置，以防止他们被较低级别的配置设置所重写。
  • 将配置设置的逻辑组组织成节的形式。

所
有的ASP.NET应用程序都从一个名为systemroot\Microsoft
.NET\Framework\versionNumber\CONFIG\Machine.conf的文件继承基本设置和默认值。
Machine.config文件用于服务器级的配置设置。其中某些设置不能再位于层级结构中较低的配置中被重写。ASP.NET配置层次结构的根是一个
称为Web.config文件的文件，它与Machine.config文件位于同一个目录中。根Web.config文件继承
Machine.config文件中的所有配置，它包括应用于所有运行某一个具体版本的.NET
Framework的ASP.NET应用程序的设置。由于每个ASP.NET应用程序都从根Web.config文件那里继承默认配置，因此只需为重写默
认配置的设置创建Web.config文件。配置文件层次结构的层次关系如图1所示：

2、Machine.config和根Web.config配置文件

Machine.config
文件包含服务器上所有Web 应用程序的ASP.NET
架构，如appSettings、connectionStrings、system.data、xmlSerializer等等配置节都是在
machine.config文件中声明的。有兴趣的可以打开machine.config文件研究研究。

processModel
元素（ASP.NET 设置架构）元素配置用于服务器（包括服务器上的所有 ASP.NET 应用程序）的处理模型。因此，processModel
设置只能放在 Machine.config 文件中，而且不能被任何 Web.config 文件中的设置重写。

对 processModel 元素的更改将只有在辅助进程重新启动之后才生效，而不是像其他配置元素那样在设置更改之后立即生效。

当ASP.NET
以辅助进程隔离模式运行在Internet 信息服务 (IIS) 6.0 中时，将使用IIS 6.0 进程模型，并将忽略
Machine.config 文件的processModel 节中的设置。若要配置进程标识、循环或其他进程模型值，要使用IIS
管理器来配置应用程序的IIS 辅助进程。将IIS 6.0 配置为在IIS 5.0隔离模式中运行 ASP.NET 后，就不会运行ASP.NET
2.0。

根Web.config 文件与Machine.config 文件存储在同一个目录中，它包含大部分system.web 配置节的默认值。在这也不一一列举了，请自行查看根web.config文件和msdn。

3、ASP.NET配置文件的结构

所
有的ASP.NET配置信息都驻留在.config（Machine.config、Web.config等等，本文以后都用Web.config代指所
有配置文件）文件中的configuration元素中。此元素中的配置信息分为两个主区域：配置节处理程序声明区域和配置节设置区域。

注：
配置文件中的标记格式是区分大小的，因为这些标记必须是格式良好的 XML，所以标记、子标记和属性是区分大小写的。标记名和属性名是Camel
大小写形式的，这意味着标记名的第一个字符是小写的，后面的任何连接单词的第一个字母是大写的。大多数情况下，字符串属性值是Pascal大小写形式的，
这意味着第一个字符是大写的，后面的任何连接单词的第一个字母也是大写的。true和false例外，它们总是小写的。

3.1、配置节处理程序声明

配
置节处理程序声明区域驻留在Web.config文件中的configSections元素内。它包含在其中声明节处理程序的ASP.NET配置
section元素。可以将这些配置节处理程序声明嵌套在sectionGroup元素中，以帮助组织配置信息。通常，sectionGroup元素表示
要应用配置设置的命名空间。例如，DotText中的配置节声明区域configSections的设置如下面的代码所示。

<configSections>
     <section name="webfx.config" type="CchenSoft.Framework.Config.ConfigurationHandler, CchenSoft.Framework"/>
     <section name="BlogConfigurationSettings" type="Dottext.Framework.Util.XmlSerializerSectionHandler, Dottext.Framework"/>
     <section name="HandlerConfiguration" type="Dottext.Framework.Util.XmlSerializerSectionHandler, Dottext.Framework"/>
</configSections>

从上述代码可以看出，DotText在web.config配置文件的配置节处理程序声明区域中声明了三个自定义配置节，分别为：

  • webfx.config
  • BlogConfigurationSettings
  • HandlerConfiguration。

<section>
只用到了name和type两种属性.name指定了配置节的名称,而type属性则规定了指定从配置文件中读取节的配置节处理程序类的名称,有两部分,
前面为处理程序的类名,后面的为Assembly名称(Assembly必须位于bin目录中)以及版本号，公匙等信息。

配置节设置区域中的每个配置节都有一个节处理程序声明。节处理程序是用来实现ConfigurationSection接口的.NET Framework类（注意：这是.NET2.0的方式，而.NET1.0、1.1节处理程序是用来实现IConfigurationSectionHandler接口的类，DotText比较早使用.NET1.1的方式）。
节处理程序声明中包含配置设置节的名称以及用来处理该节中配置数据的节处理程序类的名称，即<section>。如上例中的
BlogConfigurationSettings配置节处理程序类
为：Dottext.Framework.Util.XmlSerializerSectionHandler，他所在的程序集
为：Dottext.Framework（我们可以在bin目录下找到相应的dll）。

只需要声明配置节处理程序一次。默认ASP.NET配置节的节处理程序已在默认的Machine.config文件中进行声明。根
Web.config文件和ASP.NET应用程序中的其他配置文件都自动继承在Machine.config文件中声明的配置处理程序。只有当创建用来
处理自定义设置节的自定义节处理程序类时，才需要声明新的节处理程序。DotText中就定义了自定义的节处理程序，上例中的
Dottext.Framework.Util.XmlSerializerSectionHandler就是。关于如何创建自定义配置节及配置节处理程
序本文后面将详细介绍。

3.2、配置节设置

配置节设置区域位于配置节处理程序声明区域之后，它包含实际的配置设置。默认情况下，在内部或者在某个根配置文件中，对于
configSections区域中的每一个section和sectionGroup元素，都会有一个指定的配置节元素。配置节元素还可以包含子元素，
这些子元素与其父元素由同一个节处理程序处理。如上面DotText例子中的BlogConfigurationSettings配置节在配置节设置区域
中的设置如下所示：

<BlogConfigurationSettings type="Dottext.Framework.Configuration.BlogConfigurationSettings, Dottext.Framework">
	<Tracking enableAggBugs="true" enableWebStats="true" queueStats="false" queueStatsCount="3" enableTrackBacks="false" enablePingBacks="false" pingWeblogs="false"/>
	<EntryHandlers>
		<EntryHandler type="Dottext.Framework.EntryHandling.CommentFormatHandler, Dottext.Framework" postType="Comment" processAction="Insert" processState="PreCommit" isAsync="false"/>
		<EntryHandler type="Dottext.Framework.EntryHandling.CommentDeliveryHandler, Dottext.Framework" postType="Comment" processAction="Insert" processState="PostCommit" isAsync="true"/>
		<EntryHandler type="Dottext.Framework.EntryHandling.EntryValidationHandler, Dottext.Framework" postType="BlogPost Article" processAction="Insert Update" processState="PreCommit" isAsync="false"/>
		<!--<EntryHandler type="Dottext.Framework.EntryHandling.WeblogsPingHandler, Dottext.Framework" postType = "BlogPost" processAction ="Insert Update" processState="PostCommit" isAsync="true" />-->
		<EntryHandler type="Dottext.Framework.EntryHandling.TrackBackHandler, Dottext.Framework" postType="BlogPost Article" processAction="Insert Update" processState="PostCommit" isAsync="false"/>
		<EntryHandler type="Dottext.Framework.EntryHandling.KeyWordHandler, Dottext.Framework" postType="BlogPost Article" processAction="Insert Update" processState="PreCommit" isAsync="false"/>
		<!--<EntryHandler type="Dottext.Framework.EntryHandling.WebServicePostHandler, Dottext.Framework" postType = "BlogPost Article" processAction ="Insert" processState="PreCommit" isAsync="false" />-->
	</EntryHandlers>
	<!--
		An event is a configuration for a Dottext.Framework.ScheduledEvents.IEvent. The type property must specify a class which implements
		IEvent. You must also specify a unqiue key for each event and either a mintues interval value or timeOfDay value (both int). Interval is how often
		the event should occur. timeOfDay is the absolute time in minutes. 0 = 12:00 am, 720 = noon, 785 = 1:06 pm.

		The first "walk through" will happen 1 minute after an application restart, and then every five minutes.
	-->
	<Events>
		<!-- <Event type="Dottext.Search.SearchEngineSchedule, Dottext.Search" minutes="1" key="SearchEngine"/> -->
		<Event type="Dottext.Framework.Tracking.StatsQueueSchedule, Dottext.Framework" minutes="5" key="StatsQueue"/>
	</Events>
	<EnableMultiHost>false</EnableMultiHost>
	<!-- Checkout DottextHelper for hashing passwords -->
	<UseHashedPasswords>true</UseHashedPasswords>
	<!-- Globally control access to web services -->
	<AllowServiceAccess>true</AllowServiceAccess>
	<AllowImages>true</AllowImages>
	<!-- Globally control use of XHTML -->
	<UseXHTML>false</UseXHTML>
	<ItemCount>25</ItemCount>
	<!-- Server Time Zone -->
	<ServerTimeZone>+8</ServerTimeZone>
	<!-- 网站分类选择方式:true-单选 false-多选 -->
	<GlobalCategorySingleSelect>true</GlobalCategorySingleSelect>
	<!-- 分类级别(1或2) -->
	<CategoryDepth>1</CategoryDepth>
	<!-- Url的扩展名 -->
	<UrlFormat>aspx</UrlFormat>
	<!-- 是否允许所有用户上传文件 -->
	<EnableAllUserUpload>true</EnableAllUserUpload>
	<!-- 站点Logo图片 -->
	<Logo></Logo>
	<!-- 登录是否使用验证码 -->
	<EnableLoginAuhenCode>false</EnableLoginAuhenCode>
	<!-- 匿句用户发表评论是否使用验证码 -->
	<EnableFeedBackAuhenCode>false</EnableFeedBackAuhenCode>
</BlogConfigurationSettings>

从上述代码可以看出，在配置节设置区域配置了一个BlogConfigurationSettings元素，他的相应类
为：Dottext.Framework.Configuration.BlogConfigurationSettings。
BlogConfigurationSettings元素中又包含许多子元素，如Tracking、EntryHandlers、Events、
EnableMultiHost等等，而且他们其中有的还嵌有子元素。这些子元素是
Dottext.Framework.Configuration.BlogConfigurationSettings中的一些属性，我们在配置文件中
设置这些元素即是设置类中相应属性的值，web.config就相当于一个存储介质。这里一些配置细节看不懂也没关系，只要明白怎么设置配置
节，BlogConfigurationSettings以后将会更详细的介绍。

4、自定义配置节及配置节处理程序

要自定义配置节必须要创建相应的配置节处理程序，该处理程序是实现了
System.Configuration.ConfigurationSection类的.NET
Framework类（.NET2.0的方式，.NET1.x是
System.Configuration.IConfigurationSectionHandler）。节处理程序解释并处理Web.config文
件特定部分中XML配置元素中定义的设置，并根据配置设置返回适当的配置对象。处理程序类返回的配置对象可以是任何数据结构；它不限于任何基配置类或配置
格式。ASP.NET使用该配置对象，以对自定义配置元素进行读取和写入。

下面代码显示了DotText中BlogConfigurationSettings节的处理程序：

DotText中是以.NET1.X的方式，我们完全可以把它用.NET2.0的方式改写。跟.NET1.X相比从 System.Configuration.ConfigurationSection 类继承允许对节处理程序进行更精细的控制。

创建完配置节处理程序后，就可以向Web.config文件中配置节声明区域和配置节设置区域添加了，3.1、3.2就是以BlogConfigurationSettings为例讲了配置节声明区域和配置节设置区域这里就不在重复了。

5、访问配置文件中的配置数据

方法一：获取自定义配置对象的一个实例，并使用System.Configuration.ConfigurationManager.GetSection(System.String) 方法。

对于客户端应用程序，此方法检索通过合并应用程序配置文件、本地用户配置文件和漫游配置文件而获得的最终配置文件。GetSection 方法只能访问运行时的配置信息，不能更改这些配置信息。要更改配置，可通过使用下列Open方法中的一种来对所获得的配置文件使用System.Configuration.GetSection 方法：

方法二也是这种情况。

方法二：获取自定义配置对象的一个实例，并使用System.Web.Configuration.WebConfigurationManager.GetSection(System.String) 方法。

方法三：访问<appSettings>中的数据还可以用System.Configuration.ConfigurationManager.AppSettings属性 or System.Web.Configuration.WebConfigurationManager.AppSettings 属性

方法四：访问<connectionStrings>中的数据还可以用System.Configuration.ConfigurationManager.ConnectionStrings属性 or System.Web.Configuration.WebConfigurationManager.ConnectionStrings属性。

当然你可以用DOM来操作web.config文件读取相应的配置数据，不过此方法不推荐。

注意：1、上述方法都是在在.NET Framework 2.0 版中是新增的。

              2、其实在DotText中用的是.net 1.x中System.Configuration中的上述方法、属性，如System.Configuration.ConfigurationSettings.GetConfig(sectionName)方法。这些API 现在已过时。

时间： 2024-02-29 22:15:36

DotText源码学习——从配置文件Web.config入手（一）的相关文章

DotText源码学习——ASP.NET的工作机制

--本文是<项目驱动学习--DotText源码学习>系列的第一篇文章,在这之后会持续发表相关的文章. 概论 在阅读DotText源码之前,让我们首先了解一下ASP.NET的工作机制,可以使我们更好的理解.ASP.NET是Web服务器(IIS)的 ISAPI(Internet Server API)扩展.当IIS接收到客户端浏览器发来的请求后,它根据请求的文件类型确定由哪个ISAPI扩展来处理该请求,并将请求转发给ASP.NET(如 果是ASP.NET处理的相应文件类型的话,如*.aspx.*.

加密和解密ASP.NET配置文件(Web.config)

首先添加引用: using System.Web.Configuration; 加密操作如下: PRivate void ProtectSection(string sectionName, string provider)     {         Configuration config =             WebConfigurationManager.                 OpenWebConfiguration(Request.applicationPath);

STL源码学习——Lists(链表)

STL源码学习--Lists(链表) 今天突然想起来看看开源项目,找了找最后决定好好看看经典的STL喵~ 和STL里的代码比起来我突然觉得以前写的代码也太不规范了喵,估计很多ACMer都一样吧喵. 先从简单的看.先挑了一发list的源码来看.总结如下: 欢迎大家一起讨论喵~ 1 :list是用双向循环链表实现的,就是说 list.end()+1 == list.begin() 2 :list中有一个关键结点,这个结点是 list.end() 3 :在看了list中的erase函数后,发现这个函数

Redis源码学习——BIO

Redis源码学习之BIO BIO顾名思义,background IO,是redis中运行的后台IO. 网上千篇一律的说法是redis是单线程单进程. 实际上redis运行过程中并不是严格单进程单线程应用.Redis中的多进程: 在写入备份(RDB,AOF)的时候,会fork出子进程进行备份文件的写入.Redis中的多线程: AOF的备份模式中,如果我们设置的是AOF_FSYNC_EVERYSEC(每秒备份一次,这个设置可理解为弱同步备份),redis会create一个backgroud线程,在

Hadoop源码学习：RPC

Hadoop源码学习:RPC Hadoop RPC使用java NIO编写,达到高性能,轻量级,可控性. 主要分为四层:序列化层,函数调用层,网络传输层,服务器端处理框架 序列化层:实现Writable接口 函数调用层:java反射机制和动态代理实现函数调用 网络传输层:使用Socket机制 服务器端处理框架:基于Reactor设计模式的事件驱动I/O模型 如何使用Hadoop RPC: RPC Server: 1.定义一个协议,实现VersionedProtocol接口, public int

Java集合源码学习（二）ArrayList分析

Java集合源码学习笔记(二)ArrayList分析 1.关于ArrayList ArrayList直接继承AbstractList,实现了List. RandomAccess.Cloneable.Serializable接口, 为什么叫"ArrayList",因为ArrayList内部是用一个数组存储元素值,相当于一个可变大小的数组,也就是动态数组. (1)继承和实现 继承了AbstractList,实现了List:ArrayList是一个数组队列,提供了相关的添加.删除.修改.遍历

win7的IIS7.5不能写入配置文件web.config如何解决

WIN7或win2008 r2系统的IIS7.5添加默认文档的时候,出现错误:IIS7.5无法写入配置文件web.config,见下图.     无法写入那应该就是权限问题,这虽然是WIN7系统,但分区仍然是FAT32格式的,没有权限这一块. 在检查了这个WEB文件夹后,的确是只读属性,去掉只读属性后,问题依然一样,而且该文件夹下根本没有web.config文件,没有该文件就肯定无法写入也没有办法修改文件的只读属性. 检查发现默认网站是可以添加默认文档的,在D:inetpubwwwroot目录下

ASP.NET配置文件Web.config用法详解_实用技巧

本文实例讲述了ASP.NET配置文件Web.config用法,分享给大家供大家参考.具体分析如下: 一.认识Web.config文件 Web.config文件是一个XML文本文件,它用来储存 ASP.NET Web 应用程序的配置信息(如最常用的设置ASP.NET Web 应用程序的身份验证方式),它可以出现在应用程序的每一个目录中.当你通过VB.NET新建一个Web应用程序后,默认情况下会在根目录自动创建一个默认的   Web.config文件,包括默认的配置设置,所有的子目录都继承它的配置设

有谁写过asp.netsql2000进销存的，我购源码学习？

问题描述 有谁写过asp.netsql2000进销存的,我购源码学习?我最近想学ASP.NET看了很多书,都不行.都差不多.所以想购源码来学习,价格在3000左右,要求商业,但不要求很完善的QQ:421520476 解决方案 解决方案二:但不要求很完善的????商业项目哪个不是比较完善后才出"厂"的,你去51aspx找一下吧,应该有供学习的--