asp.net

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

2010-12-27

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  常用设定区段标记
设 定 区 段
 说    明
 
<anonymousIdentification>
 控制 Web 应用程序的匿名用户,详细说明参阅第 16 章
 
<authentication>
 设定 ASP.NET 验证方式,参阅第 13 章
 
<authorization>
 设定 ASP.NET 用户授权,参阅第 13 章
 
<browserCaps>
 设定浏览程序兼容组件 HttpBrowserCapabilities
 
<compilation>
 设定 ASP.NET 应用程序的编译方式
 
<customErrors>
 设定 ASP.NET 应用程序的自订错误处理
 
<globalization>
 关于 ASP.NET 应用程序的全球化设定,也就是本地化设定
 
<httpHandlers>
 设定 HTTP 处理是对应到 URL 请求的 IHttpHandler 类
 
<httpModules>
 创建、删除或清除 ASP.NET 应用程序的 HTTP 模块
 
<httpRuntime>
 ASP.NET 的 HTTP 执行期相关设定
 
<identity>
 设定 ASP.NET 应用程序的用户识别是使用服务器端用户账号的权限(impersonate 属性),或指定的用户账号(userName 和 password 属性)
 
<machineKey>
 设定在使用窗体基础验证的 Cookie 数据时,用来加码和解码的金钥值
 
<membership>
 设定 ASP.NET 的 Membership 机制,参阅第 13 章
 
<pages>
 设定 ASP.NET 程序的相关设定,即 Page 指引命令的属性
 
<profile>
 设定个人化信息的 Porfile 对象,详细说明参阅第 14 章
 
<roles>
 设定 ASP.NET 的角色管理,详细说明参阅第 13 章
 
<sessionState>
 设定 ASP.NET 应用程序的 Session 状态 HttpModule
 

(续表)  
设 定 区 段
 说    明
 
<siteMap>
 设定 ASP.NET 网站导览系统,详细说明参阅第 12 章
 
<trace>
 ASP.NET 应用程序的除错功能,可以设定是否追踪应用程序的执行
 
<webParts>
 设定ASP.NET应用程序的网页组件,详细说明参阅第18章
 
<webServices>
 设定 ASP.NET 的 Web 服务,详细说明参阅第 18 章
 

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> 标记的常用属性
属    性
 说    明
 
mode
 Session 状态存储的位置可以是 off(不存储)、InProc(使用Cookie)、StateServer(使用状态服务器)和 SqlServer(存储在 SQL Server)
 
cookieless
 是否使用 Cookie 存储 Session 状态。True 为不使用,False 为使用
 
timeout
 Session 时间的期限,以分钟计,默认值为20 分钟,其功能如同 Session 对象的 TimeOut 属性
 

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 区段的相关属性
属    性
 说    明
 
 requestEncoding
 指定 Request 请求的编码方式,默认为UTF-8 编码,大多数情况 requestEncoding 和 responseEncoding 属性的编码应该相同
 
 responseEncoding
 指定 Response 响应的编码方式,默认为UTF-8 编码
 
 fileEncoding
 指定扩展名 .aspx、.asmx 和 .asax 文件默认的编码方式
 
 culture
 指定本地化的语系地区,不同的地区拥有不同的日期时间格式、数字等默认的本地化设定
 

上表culture属性值可以使用语系和地区代码,以中文语系来说的 culture 属性值如表11-12所示。
表11-12  culture 属性值可以使用语系和地区代码
culture 属性值
 语系或地区
 
 zh-HK
 香港
 
 zh-MO
 澳门
 
 zh-CN
 中国大陆
 
 zh-SG
 新加坡
 
 zh-TW
 台湾
 
 zh-CHS
 中文简体
 
 zh-CHT
 中文繁体
 

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区段的相关属性
属    性
 说    明
 
debug
 是否打开除错模式,默认为 False 不打开,True 为打开
 
defaultLanguage
 默认的程序语言,例如C#、VB 或 PERL,默认值是 VB
 
explicit
 Microsoft Visual Basic 是否使用 explicit 方式编译,也就是所有变量都需要事先声明,默认值是 True
 

在 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区段的相关属性
属    性
 说    明
 
mode
 是否启动自订错误功能,On为启动自订错误处理,此时需要指定 defaultRedirect 属性,Off为取消自订错误处理,RemoteOnly 指定自订错误处理只显示在远程客户端,本地计算机仍然显示 ASP.NET 默认错误网页,此为默认值
 
defaultRedirect
 指定 URL 网址,当错误产生时就转址到此网址的网页,此例是显示 Ch11-7error.htm 网页
 

在 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 网页。


本文来自CSDN博客,转载请标明出处:http://blog.csdn.net/anerou/archive/2008/05/05/2391546.aspx