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)的身份验证配置站点,当没有登录的用户访问需要身份验证的网页时,网页自动跳转到登录网页,程序代码如下:
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>节实现不检测用户在浏览器输入的内容中,是否存在潜在的危险数据,在从客户端回发页时将检查加密的视图状态,以及验证视图状态是否已在客户端被篡改。程序代码如下:
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>节的设置,程序代码如下:
2 </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>区域之后,为已声明的节做实际的配置设置。
例如,下面代码演示了如何创建一个节存储数据库连接字符串:
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>