ASP.NET项目站点配置Web.Config文件

ASP.NET配置文件是基于XML的文本文件（每个都命名为Web.Config），可以出现在ASP.NET Web应用程序服务器上的任何目录中。它可以包含标准的XML文档元素（包括格式正确的标记、注释、文本、cdata等）。该文件的编辑格式可以为ANSI、UTF-8或Unicode，系统自动检测编码。

Web.Cconfig文件中包括一些基本的节，下面分别对这些节的配置进行介绍。

1．配置<authentication>

<authentication>节主要用于配置ASP.NET 2.0身份验证。在<authentication>节中，主要对mode属性进行设置，该属性共提供4个参数，分别为Windows、Forms、PassPort和None。下面分别对这4个参数进行介绍。

（1）Windows：Internet信息服务（IIS）根据应用程序的设置执行身份验证。在IIS中必须禁止匿名访问。

（2）Forms：需要工程创建者为用户提供一个输入凭据的自定义窗体，然后在应用程序中验证身份。用户的凭据标记存储于Cookie对象中。

（3）PassPort：身份验证是通过Microsoft的集中身份验证服务执行的，它为成员站点提供了不同用户访问此应用程序的资源。

（4）None：不执行身份验证。

该元素只能在计算机、站点或应用程序级声明。<authentication>节必须与<authorization>节配合使用。

例如，下面代码为<authentication>节基于窗体（Forms）的身份验证配置站点，当没有登录的用户访问需要身份验证的网页时，网页自动跳转到登录网页，程序代码如下：

说明：

元素loginUrl表示登录网页的名称，name表示Cookie名称。

2．配置<authorization>

<authorization>节用于控制对URL资源的客户端访问权限（如允许匿名用户访问）。该元素可以在任何级别（计算机、站点、应用程序、子目录或页）上声明，必须与<authentication>节配合使用。

例如，通过配置<deny users="?"/>禁止匿名用户的访问，程序代码如下：

 用户可以使用user.identity.name属性来获取已经通过验证的当前用户名，也可以使用Web.Security.FormsAuthentication.RedirectFromLoginPage方法将已验证的用户重定向到用户请求的页面。

3．配置<compilation>

<compilation>节用于配置ASP.NET 2.0应用程序的所有编译设置。<compilation>节主要提供两个属性，分别为DefaultLanguage和Debug，其说明如下。

（1）DefaultLanguage：定义了ASP.NET 2.0后台代码语言，可以设置C#、VB等语言。

（2）Debug：该属性设置为True时，将启动aspx调试；设置为False时，可以提高应用程序的运行性能。建议在程序开发调试时，设置为Debug=“True”，交于客户使用时，设置为Debug=“False”。

4．配置<customErrors>

<customErrors>节用于为ASP.NET 2.0应用程序提供有关自定义错误信息的信息。它不适用于XML Web Services中发生的错误。<customErrors>节中主要设置mode属性，此属性共有3个属性值，其含义分别如下。

（1）On：一直显示自定义信息。

（2）Off：一直显示详细的ASP.NET 2.0错误信息。

（3）RemoteOnly：只对不在本地Web服务器上运行的用户显示自定义信息。

例如，通过配置<customErrors>节实现当发生错误时，将网页跳转到自定义的错误页面。程序代码如下：

 说明：

上述代码中元素defaultRedirect表示自定义的错误网页的名称。mode元素表示对不在本地Web服务器上运行的用户显示自定义（友好的）信息。

5．配置<httpRuntime>

<httpRuntime>节用于配置ASP.NET 2.0 HTTP运行库设置。该节可以在计算机、站点、应用程序和子目录级别声明。

例如，通过对<httpRuntime>节的设置，指定了用户上传文件最大为4M，最长时间为60s，最多请求数为100，程序代码如下：

 1 <httpRuntime maxRequestLength="4096" executionTimeout="60" appRequestQueueLimit="100"/>

6．配置<pages>

<pages>节用于标识特定页的配置设置（例如，是否启用会话状态或视图状态，是否检测用户的输入等）。<pages>节可以在计算机、站点、应用程序和子目录级别声明。

例如，通过配置<pages>节实现不检测用户在浏览器输入的内容中，是否存在潜在的危险数据，在从客户端回发页时将检查加密的视图状态，以及验证视图状态是否已在客户端被篡改。程序代码如下：

7．配置<sessionState>

<sessionState>节主要用于为当前应用程序配置会话状态设置（例如，设置是否启用会话状态、会话状态保存位置等）。

SessionState各参数的含义如下。

（1）mode：该参数用于设置存储会话状态。状态包括Off、Inproc、StateServer和SqlServer。Off表示禁用会话状态，Inproc表示工作进程自身存储会话状态，StateServer表示将把会话信息存放在一个单独的ASP.NET 2.0状态服务中，SQL Server表示将把会话信息存放在SQL Server数据库中。

（2）StateConnectionString：该参数用于设置ASP.NET 2.0应用程序存储远程会话状态的服务器名，默认名为本地。

（3）Cookieless：当参数Cookieless的属性设置为True时，表示不使用Cookie会话标识客户；反之设置为False时，表示启动Cookie会话状态。

（4）SqlConnectionString：该参数用于设置SQL Server数据库连接。

（5）Timeout：该参数用于设置会话时间，超过该期限，会自动中断会话，默认设置为20。

例如，下面对<sessionState>节的设置，程序代码如下：

 说明：

mode="InProc"表示在本地储存会话状态（也可以选择储存在远程服务器或SAL服务器中或不启用会话状态）；cookieless="true"表示如果用户浏览器不支持Cookie时启用会话状态（默认为False）；timeout="20"表示会话可以处于空闲状态的分钟数。

8．配置<trace>

<trace>节用于配置ASP.NET 2.0跟踪服务，主要用来判断程序出错的位置。

例如，下面代码为Web.config中的默认配置：

说明：

上述代码中，enabled="false"表示不启用跟踪，requestLimit="10"表示指定在服务器上存储的跟踪请求的数目，pageOutput="false"表示只能通过跟踪实用工具访问跟踪输出，traceMode="SortByTime"表示以处理跟踪的顺序来显示跟踪信息，localOnly="true" 表示跟踪查看器（trace.axd）只用于宿主Web服务器。

9．自定义Web.Config文件配置

自定义Web.Config文件配置节过程分为两步，步骤如下。

（1）在配置文件顶部<configSections>和</configSections>标记之间，声明配置节的名称和处理该节中配置数据的.NET Framework类名称。

（2）在<configSections>区域之后，为已声明的节做实际的配置设置。

例如，下面代码演示了如何创建一个节存储数据库连接字符串：