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

时间:2022-12-04 11:33:15

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)的身份验证配置站点,当没有登录的用户访问需要身份验证的网页时,网页自动跳转到登录网页,程序代码如下:

 

1 <authentication mode="Forms" >  
2     <forms loginUrl="logon.aspx" name=".FormsAuthCookie"/> 
3 </authentication>

说明:

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

 

2.配置<authorization>

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

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

1 <authorization> 
2     <deny users="?"/>
3 </authorization>
4 
5  

用户可以使用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>节实现当发生错误时,将网页跳转到自定义的错误页面。程序代码如下:

1 <customErrors defaultRedirect="ErrorPage.aspx" mode="RemoteOnly">
2 </customErrors>

 说明:

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

 

5.配置<httpRuntime>

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

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

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

 

6.配置<pages>

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

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

1 <pages buffer="true" enableViewStateMac="true" validateRequest="false"/>

 

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>节的设置,程序代码如下:

1 <sessionState mode="InProc" cookieless="true" timeout="20"/>
2 </sessionState>

 说明:

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

 

8.配置<trace>

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

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

1 <trace enabled="false" requestLimit="10" pageOutput="false" traceMode="SortByTime" localOnly="true" />

说明:

上述代码中,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>区域之后,为已声明的节做实际的配置设置。

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

 1 <configuration>
 2   <configSections>
 3     <section name="appSettings" type="System.Configuration.NameValueFileSectionHandler, System, Version= 1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
 4   </configSections>
 5   <appSettings>
 6     <add key="scon" value="server=a;database=northwind;uid=sa;pwd=123"/>
 7   </appSettings>
 8   <system.web>
 9     ..... 
10   </system.web>
11 </configuration>