.net中Web.config文件的基本原理及相关设置

11.7  使用web.config配置文件

Web配置文件web.config是Web 应用程序的数据设定文件，它是一份 XML 文件，内含 Web 应用程序相关设定的 XML 标记，可以用来简化 ASP.NET 应用程序的相关设定。

11.7.1  Web配置文件的基础

Web 配置文件web.config位于 Web 应用程序的任何目录中，子目录如果没有 web.config 文件，就是继承父目录 web.config 文件的相关设定；如果子目录有 web.config 文件，就会覆盖父目录 web.config 文件的相关设定。

.NET Framework 根配置文件名称是 Machine.config，存储在 Windows 文件夹下Microsoft.NET/Framework/<version>/CONFIG，整个 Web 服务器所有 Web 应用程序的设定都是继承此配置文件，如果需要更改设定，可使用 web.config 文件在各目录中覆盖相关设定。

Web 配置文件是一份 XML 文件，在 XML 标记的属性就是设定值，标记名称和属性值格式是字符串，第 1 个开头字母是小写，之后每一字头是大写，例如<appSettings>。Web 配置文件的范例如下所示。

<configuration>

  <appSettings>

    <add key="dbType" value="Access Database"/>

  </appSettings>

  <connectionStrings>

    <add name="provider"

         connectionString="Microsoft.Jet.OLEDB.4.0;"/>

    <add name="database"

         connectionString="/Ch11/Products.mdb"/>

  </connectionStrings>

  <system.web>

    <sessionState cookieless="false" timeout="10"/>

    <globalization

       fileEncoding="gb2312"

       requestEncoding=" gb2312"

       responseEncoding=" gb2312"

       culture="zh-CN"/>

    <compilation defaultLanguage="VB" debug="true"/>

    <customErrors mode="RemoteOnly"/>

  </system.web>

</configuration>

上述 Web 配置文件的根标记是<configuration>，其子标记<appSettings>、<connectionStrings>和<system.web>是各设定区段。在<system.web>下的设定区段属于ASP.NET相关设定。常用设定区段标记说明如表11-9所示。

表11-9  常用设定区段标记

(续表)  

11.7.2  appSetting与connectionStrings区段的参数和连接字符串

在 Web 配置文件的 <appSettings> 区段可以创建 ASP.NET 程序所需的参数，ASP.NET 2.0 新增 <connectionStrings> 区段，可以指定数据库连接字符串。

1. Web配置文件web.config的内容

在web.config文件<configuration>标记的子标记<appSettings> 和 <connectionStrings> 区段中，可以创建参数和数据库连接字符串，如下所示。

<configuration>

  <appSettings>

    <add key="dbType" value="Access Database"/>

  </appSettings>

  <connectionStrings>

    <add name="provider"

         connectionString="Microsoft.Jet.OLEDB.4.0;"/>

    <add name="database"

         connectionString="/Ch11/Products.mdb"/>

  </connectionStrings>

  <system.web>

    ………

  </system.web>

</configuration>

上述 <appSettings> 标记的子标记是创建参数，每一个 <add> 标记可以创建一个参数，属性 key 是参数名称，value 是参数值。

在 <connectionStrings> 标记的 <add> 子标记也可以创建连接字符串，属性 name 是名称，connectionString 属性是连接字符串内容。

2. Conifguration API的基础

ASP.NET 2.0 的 Configuration API 可以存取 web.config 和 machine.config 配置文件的设定数据。在ASP.NET 程序中是使用 System.Web.Configuration 名称空间的 WebConfigurationManager 类来存取相关设定。首先导入所需的名称空间，如下所示。

<%@ Import NameSpace="System.Web.Configuration" %>

上述 Import命令导入 System.Web.Configuration 名称空间，接着就可以获取 <appSettings> 区段创建的参数，如下所示。

Dim dbType As String = WebConfigurationManager.AppSettings("dbType")

上述程序代码使用AppSettings属性获取指定参数，使用的是<add>标记的key 属性。同样可以获取<connectionStrings>区段的数据库连接字符串，如下所示。

Dim pd, db As String

pd = WebConfigurationManager.ConnectionStrings( _

              "provider").ConnectionString

db = WebConfigurationManager.ConnectionStrings( _

              "database").ConnectionString

上述程序代码使用 ConnectionStrings 属性获取参数 provider 和 database 的值，即 <add> 标记的 name 属性。完整 ASP.NET 程序范例是 Ch11-7-2.aspx，其执行结果使用表格显示数据表记录，如图11-12所示。

图11-12  Ch11-7-2.aspx运行结果

上图的Access Database是<appSettings>区段的应用程序参数，数据表是使用 GridView控件来显示记录数据，数据库连接字符串是定义在web.config 文件。

11.7.3  在sessionState区段设定Session状态

ASP.NET的Session状态管理拥有扩充性，可以在web.config文件的 <sessionState>区段设定Session状态管理，它属于<system.web>的子标记，如下所示。

<configuration>

  <system.web>

      <sessionState cookieless="false" timeout="10"/>

    ………

  </system.web>

</configuration>

上述<sessionState>标记的常用属性如表11-10所示。

表11-10  <sessionState> 标记的常用属性

11.7.4  globalization区段的编码设定

在<system.web>子标记的<globalization>区段是本地化相关设定，可以设定 ASP.NET 程序默认的文件编码、请求和响应的编码方式、日期时间格式和数字等本地化设定，如下所示。

<configuration>

  <system.web>

    <globalization

       fileEncoding="gb2312"

       requestEncoding=" gb2312"

       responseEncoding=" gb2312"

       culture="zh-CN"/>

    ………

  </system.web>

</configuration>

上述标记属性设定编码方式gb2312，culture是本地化设定值，zh-CN为中国大陆。相关属性说明如表11-11所示。

表11-11  globalization 区段的相关属性

上表culture属性值可以使用语系和地区代码，以中文语系来说的 culture 属性值如表11-12所示。

表11-12  culture 属性值可以使用语系和地区代码

11.7.5  compilation区段的编译设定

在 <system.web> 子标记的 <compilation> 区段，可以设定 ASP.NET 程序默认的编译方式，如下所示。

<configuration>

  <system.web>

    <compilation defaultLanguage="VB" debug="true"/>

    ………

  </system.web>

</configuration>

上述标记属性设定默认程序语言和是否打开除错模式。相关属性说明如表11-13所示。

表11-13  compilation区段的相关属性

在 web.config 文件中使用 compilation 标记，如同 ASP.NET 程序文件开头加上 Page 命令的 Language 和 Debug 属性，如下所示。

<%@ Page Language="VB" Debug="True" %>

11.7.6  customErrors区段的自订错误网页

在 <system.web> 子标记 <customErrors> 区段，可以设定 ASP.NET 程序的自订错误网页。例如错误代码 HTTP 404，如图11-13所示。

图11-13  显示错误信息

上述错误信息是默认错误网页，显示找不到网页数据错误。在 <customErrors> 区段可以指定错误网页，如下所示。

<configuration>

  <system.web>

    <customErrors mode="On" defaultRedirect="Ch11-7error.htm"/>

    ………

  </system.web>

</configuration>

上述标记属性设定模式为 On。相关属性说明如表11-14所示。

表11-14  customErrors区段的相关属性

在 customErrors 区段拥有多个 error 子标记，每一个 error 标记可以定义 HTTP 错误代码的自订错误网页，如下所示。

<configuration>

   <system.web>

      <customErrors mode="On"

                    defaultRedirect="Ch11-7error.htm">

         <error statusCode="404"

               redirect="NotFoundError.htm"/>

      </customErrors>

   </system.web>

</configuration>

上述的 error 标记使用 statusCode 属性指定 HTTP 错误代码为 404，如果错误产生，就转址到 redirect 属性值的 NotFoundError.htm 网页。