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

11.7  使用web.config配置文件

Web配置文件web.configWeb 应用程序的数据设定文件,它是一份 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.NETSession状态管理拥有扩充性,可以在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>

上述标记属性设定编码方式gb2312culture是本地化设定值,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 网页。

.net中Web.config文件的基本原理及相关设置,古老的榕树,5-wow.com

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。