在ASP.NET中创建自定义配置节（翻译）
日期：2014-04-25 浏览次数：20989 次
一、介绍
ASP.NET Web应用程序用一种内置的方法访问简单的“键/值”配置数据。在Web.config文件中，你可以创建节来存储简单的“键/值”对。例如，新建一个ASP.NET项目，在Web.config文件中添加如下的标记作为元素的子标记：
该节包含了用两个标记定义的“键/值”对，你可以通过Page对象内置的ConfigurationSettings属性获得它们的值。作为开始，在你的项目中新建一个名为customItems.aspx的Web窗体，将下面的代码添加到该窗体的Page_Load事件中：
Dim aKey As String
Response.Write("
AppSettings
")
For Each aKey In ConfigurationSettings.AppSettings.Keys
Response.Output.WriteLine(aKey & "=" & _
ConfigurationSettings.AppSettings.Item(aKey))
Next
编译运行customItems.aspx Web窗体，就能看到标记的值了。For循环检索了节中所有的标记，并将键及其对应的属性值显示出来。这种简单的“键/值”机制对于许多一般性需求来讲是完美的，比如在整个应用范围内存储数据库连接字符串，但对于更复杂的数据它却不是足够健壮。幸运的是，微软同样建立了创建自定义配置数据的机制，利用ASP.NET框架读取一个或多个节，而不是仅通过某一具体应用中的代码去读固定的标记列表。节定义了框架预期在Web.config文件其余部分发现的标记名称，同时声明了处理其特定类型内容的类的类型和位置。
在解析配置文件时，ASP.NET引擎通过读取元素的标记建立起一个可能的标记列表，其中每一个标记都包含了一个“name”和一个“type”，声明了在文件其余内容中预期的标记名称和相应的配置节处理程序。下面用一个小实验来演示一下整个工作过程。在项目中Web.comfig文件末尾的标记前边，添加一个新标记如下。
保存Web.config文件并运行项目，将会得到一个“无法识别的配置节‘customItems’”的错误，这个错误的发生是由于没有声明标记的节处理程序所致。但是如果浏览整个Web.config文件，你不会看到有任何一个标记的配置节处理程序声明，这就带来了一个问题，这些配置节处理程序究竟是在哪儿声明的？（在读这篇文章的时候，如果你同时按照上述步骤进行了操作，那么请在继续下去之前将标记从Web.config文件中删掉。）
事实上每一个Web应用程序都有两个配置文件：保存在系统文件夹下的根machine.config文件和在你应用程序根目录下的Web.config文件。你可以在操作系统文件夹下的\Microsoft.NET\Framework\\CONFIG文件夹里找到machine.config文件，其中对应于服务器上安装并被激活的.NET框架。machine.config文件中关于配置的设置适用于在服务器上的所有应用程序，除非被局部设置所重置。浏览整个machine.config文件，可以看到一个包含了一组标记的标记，这些标记声明了你能在Web.config文件中看到的那些默认标记的配置节处理程序。为了使这一过程更易于理解，可以更进一步将标记分组放在标记中，其中分别存放一组相关的节标记。
我之所以引出machine.config文件，是因为有两种方法添加自定义标记：可以用任一种缺省的系统配置节处理程序来解析自定义标记内容，也可以创建你自己的配置节处理程序。
二、使用系统配置节处理程序解析自定义标记
1.在元素中创建一个新的标记，如下：
type="System.Configuration.NameValueSectionHandler,System, Version=1.0.3300.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"
/>
作者提醒：Version和PublicKeyToken的值可能和你的.NET框架版本不同，要在系统中找出正确的值只需从任一个已存在的元素中复制即可！
2.将新建的标记放在Web.config文件中的结束标记之前进行测试，例如：
key="SomeKey" value="SomeValue" />
3.保存Web.config文件，将如下高亮部分代码增加到customItems.aspx Web窗体中的Page_Load事件中：
Dim aKey As String
Response.Write("
AppSettings
")
For Each aKey In ConfigurationSettings.AppSettings.Keys
Response.Output.WriteLine(aKey & "=" & _
ConfigurationSettings.AppSettings.Item(aKey))
Next
Response.Write("
CustomSystemItems
")
For Each aKey In CType(ConfigurationSettings.GetConfig _
("customSystemItems"), _
System.Collections.Specialized.NameValueCollection).Keys
Response.Output.WriteLine(aKey & "=" & _
ConfigurationSettings.AppSettings.Item(aKey))
Next
4.现在再次编译执行该Web窗体。这次，可以看到CustomSystemItem头信息尾随了一行“SomeKey=SomeValue”，它对应着在元素中增加的一个子元素。
通过修改machine.config文件，可以将定义好的自定义标记应用到在服务器上运行的任意Web应用程序上。但很可能你并不总是希望标记处理程序应用于所有应用程序，如果是这样，可以在Web.config文件中增加标记和标记，而不是在machine.config文件中。测试一下，首先删除之前在machine.config文件中定义的标记并保存，接着，在Web.config文件中紧跟着开始标记增加一个标记，并在其中置入标记。例如：
type="System.Configurati
ASP.NET Web应用程序用一种内置的方法访问简单的“键/值”配置数据。在Web.config文件中，你可以创建节来存储简单的“键/值”对。例如，新建一个ASP.NET项目，在Web.config文件中添加如下的标记作为元素的子标记：
该节包含了用两个标记定义的“键/值”对，你可以通过Page对象内置的ConfigurationSettings属性获得它们的值。作为开始，在你的项目中新建一个名为customItems.aspx的Web窗体，将下面的代码添加到该窗体的Page_Load事件中：
Dim aKey As String
Response.Write("
AppSettings
")
For Each aKey In ConfigurationSettings.AppSettings.Keys
Response.Output.WriteLine(aKey & "=" & _
ConfigurationSettings.AppSettings.Item(aKey))
Next
编译运行customItems.aspx Web窗体，就能看到标记的值了。For循环检索了节中所有的标记，并将键及其对应的属性值显示出来。这种简单的“键/值”机制对于许多一般性需求来讲是完美的，比如在整个应用范围内存储数据库连接字符串，但对于更复杂的数据它却不是足够健壮。幸运的是，微软同样建立了创建自定义配置数据的机制，利用ASP.NET框架读取一个或多个节，而不是仅通过某一具体应用中的代码去读固定的标记列表。节定义了框架预期在Web.config文件其余部分发现的标记名称，同时声明了处理其特定类型内容的类的类型和位置。
在解析配置文件时，ASP.NET引擎通过读取元素的标记建立起一个可能的标记列表，其中每一个标记都包含了一个“name”和一个“type”，声明了在文件其余内容中预期的标记名称和相应的配置节处理程序。下面用一个小实验来演示一下整个工作过程。在项目中Web.comfig文件末尾的标记前边，添加一个新标记如下。
保存Web.config文件并运行项目，将会得到一个“无法识别的配置节‘customItems’”的错误，这个错误的发生是由于没有声明标记的节处理程序所致。但是如果浏览整个Web.config文件，你不会看到有任何一个标记的配置节处理程序声明，这就带来了一个问题，这些配置节处理程序究竟是在哪儿声明的？（在读这篇文章的时候，如果你同时按照上述步骤进行了操作，那么请在继续下去之前将标记从Web.config文件中删掉。）
事实上每一个Web应用程序都有两个配置文件：保存在系统文件夹下的根machine.config文件和在你应用程序根目录下的Web.config文件。你可以在操作系统文件夹下的\Microsoft.NET\Framework\\CONFIG文件夹里找到machine.config文件，其中对应于服务器上安装并被激活的.NET框架。machine.config文件中关于配置的设置适用于在服务器上的所有应用程序，除非被局部设置所重置。浏览整个machine.config文件，可以看到一个包含了一组标记的标记，这些标记声明了你能在Web.config文件中看到的那些默认标记的配置节处理程序。为了使这一过程更易于理解，可以更进一步将标记分组放在标记中，其中分别存放一组相关的节标记。
我之所以引出machine.config文件，是因为有两种方法添加自定义标记：可以用任一种缺省的系统配置节处理程序来解析自定义标记内容，也可以创建你自己的配置节处理程序。
二、使用系统配置节处理程序解析自定义标记
1.在元素中创建一个新的标记，如下：
type="System.Configuration.NameValueSectionHandler,System, Version=1.0.3300.0,Culture=neutral,PublicKeyToken=b77a5c561934e089"
/>
作者提醒：Version和PublicKeyToken的值可能和你的.NET框架版本不同，要在系统中找出正确的值只需从任一个已存在的元素中复制即可！
2.将新建的标记放在Web.config文件中的结束标记之前进行测试，例如：
key="SomeKey" value="SomeValue" />
3.保存Web.config文件，将如下高亮部分代码增加到customItems.aspx Web窗体中的Page_Load事件中：
Dim aKey As String
Response.Write("
AppSettings
")
For Each aKey In ConfigurationSettings.AppSettings.Keys
Response.Output.WriteLine(aKey & "=" & _
ConfigurationSettings.AppSettings.Item(aKey))
Next
Response.Write("
CustomSystemItems
")
For Each aKey In CType(ConfigurationSettings.GetConfig _
("customSystemItems"), _
System.Collections.Specialized.NameValueCollection).Keys
Response.Output.WriteLine(aKey & "=" & _
ConfigurationSettings.AppSettings.Item(aKey))
Next
4.现在再次编译执行该Web窗体。这次，可以看到CustomSystemItem头信息尾随了一行“SomeKey=SomeValue”，它对应着在元素中增加的一个子元素。
通过修改machine.config文件，可以将定义好的自定义标记应用到在服务器上运行的任意Web应用程序上。但很可能你并不总是希望标记处理程序应用于所有应用程序，如果是这样，可以在Web.config文件中增加标记和标记，而不是在machine.config文件中。测试一下，首先删除之前在machine.config文件中定义的标记并保存，接着，在Web.config文件中紧跟着开始标记增加一个标记，并在其中置入标记。例如：
type="System.Configurati
免责声明： 本文仅代表作者个人观点，与爱易网无关。其原创性以及文中陈述文字和内容未经本站证实，对本文以及其中全部或者部分内容、文字的真实性、完整性、及时性本站不作任何保证或承诺，请读者仅作参考，并请自行核实相关内容。
