web.config详解

最新推荐文章于 2024-04-24 13:11:31 发布

GoodShot

最新推荐文章于 2024-04-24 13:11:31 发布

阅读量1.8k

点赞数

分类专栏： ASP.NET 文章标签： asp.net authentication redirect 数据库 compilation

ASP.NET 专栏收录该内容

326 篇文章 2 订阅

订阅专栏

web.config详解(配置文件节点说明） (另外，参见http://blog.csdn.net/goodshot/article/details/8510550)

web.config文件是一个XML文件，它的根结点是<configuration>，在<configuration>节点下的常见子节点有：<configSections>、<appSettings>、<connectionStrings> 和<system.web>。其中<appSettings>节点主要用于配置一些网站的应用配置信息，而<connectionStrings>节点主要用于配置网站的数据库连接字符串信息。

<system.web>节点主要是网站运行时的一些配置，它的常见节点有如下：

1.<appSettings>节点
<appSettings>节点主要用来存储asp.net应用程序的一些配置信息

2.<compilation>节点

<compilation>节点配置 ASP.NET 使用的所有编译设置。默认的debug属性为“true”，即允许调试，在这种情况下会影响网站的性能，所以在程序编译完成交付使用之后应将其设为“false”。

3.<authentication>节点

设置asp.net身份验证模式，有四种身份验证模式，它们的值分别如下：
Mode 说明
Windows 使用Windows身份验证，适用于域用户或者局域网用户。
Forms 使用表单验证，依靠网站开发人员进行身份验证。
Passport 使用微软提供的身份验证服务进行身份验证。
None 不进行任何身份验证。

4.<customErrors>节点
<customErrors>节点用于定义一些自定义错误信息的信息。此节点有Mode和defaultRedirect两个属性，其中defaultRedirect属性是一个可选属性，表示应用程序发生错误时重定向到的默认URL，如果没有指定该属性则显示一般性错误。 Mode属性是一个必选属性，它有三个可能值，它们所代表的意义分别如下：
Mode 说明
On 表示在本地和远程用户都会看到自定义错误信息。
Off 禁用自定义错误信息，本地和远程用户都会看到详细的错误信息。
RemoteOnly 表示本地用户将看到详细错误信息，而远程用户将会看到自定义错误信息。
这里有必要说明一下本地用户和远程用户的概念。当我们访问asp.net应用程时所使用的机器和发布asp.net应用程序所使用的机器为同一台机器时成为本地用户，反之则称之为远程用户。在开发调试阶段为了便于查找错误Mode属性建议设置为Off，而在部署阶段应将Mode属性设置为On或者 RemoteOnly，以避免这些详细的错误信息暴露了程序代码细节从而引来黑客的入侵。

5.<error>子节点
在<customErrors>节点下还包含有<error>子节点，这个节点主要是根据服务器的HTTP错误状态代码而重定向到我们自定义的错误页面，注意要使<error>子节点下的配置生效，必须将<customErrors>节点节点的Mode属性设置为“On”。下面是一个例子：

<customErrors mode="On" defaultRedirect="GenericErrorPage.htm">
<error statusCode="403" redirect="403.htm" />
<error statusCode="404" redirect="404.htm" />
</customErrors>
在上面的配置中如果用户访问的页面不存在就会跳转到404.htm页面，如果用户没有权限访问请求的页面则会跳转到403.htm页面，403.htm和404.htm页面都是我们自己添加的页面，我们可以在页面中给出友好的错误提示。

6.<httpHandlers>节点
<httpHandlers>节点用于根据用户请求的URL和HTTP谓词将用户的请求交给相应的处理程序。可以在配置级别的任何层次配置此节点，也就是说可以针对某个特定目录下指定的特殊文件进行特殊处理。下面是与machine.config文件同一目录下的 web.config文件中的<httpHandlers>节点配置： (大多数已略)

<add path=".aspx" verb="" type="System.Web.UI.PageHandlerFactory" validate="true"/>

<add path="" verb="GET,HEAD,POST" type="System.Web.DefaultHttpHandler" validate="true"/>
<add path=".exe.config" verb="GET,HEAD" type="System.Web.StaticFileHandler" validate="true"/>
<add path=".config" verb="" type="System.Web.HttpForbiddenHandler" validate="true"/>

从上面的配置中可以看出，针对.config文件的Get或者Post请求都会交给 System.Web.HttpForbiddenHandler来处理，处理的结果就是用户不能查看或者下载相关的文件。如果我们某个文件夹下的文件或者某个类型的文件不允许用户下载，可以在</httpHandlers>节点中增加相应的子节点。
下面我们以一个例子来说明<httpHandlers>节点的用法，在我们的asp.net应用程序中建立一个IPData目录，在IPData目录中创建一个IPData.txt文件，然后在Web.config中添加以下配置：

<httpHandlers>
<add path="IPData/.txt" verb="" type="System.Web.HttpForbiddenHandler"/>
</httpHandlers>
上面的代码的作用是禁止访问IPData目录下的任何txt文件。

7.<httpRuntime>节点
<httpRuntime>节点用于对 ASP.NET HTTP 运行库设置。该节可以在计算机、站点、应用程序和子目录级别声明。
例如下面的配置控制用户最大能上传的文件为40M（401024K），最大超时时间为60秒，最大并发请求为100个。

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

8.<pages>节点
<pages>节点用于表示对特定页设置，主要有三个属性，分别如下：
属性名说明
buffer 是否启用了 HTTP 响应缓冲。
enableViewStateMac 是否应该对页的视图状态运行计算机身份验证检查 (MAC)，以放置用户篡改，默认为false，如果设置为true将会引起性能的降低。
validateRequest 是否验证用户输入中有跨站点脚本攻击和SQL注入式漏洞攻击，默认为true，如果出现匹配情况就会发 HttpRequestValidationException 异常。对于包含有在线文本编辑器页面一般自行验证用户输入而将此属性设为false。
下面就是一个配置节点的例子：
<pages buffer="true" enableViewStateMac="true" validateRequest="false"/>

9.<sessionState>节点
<sessionState>节点用于配置当前asp.net应用程序的会话状态配置。以下就是一个常见配置：
<sessionState cookieless="false" mode="InProc" timeout="30" />
上面的节点配置是设置在asp.net应用程序中启用Cookie，并且指定会话状态模式为在进程中保存会话状态，同时还指定了会话超时为30分钟。
<sessionState>节点的Mode属性可以是以下几种值之一：
属性值说明
Custom 使用自定义数据来存储会话状态数据。
InProc 默认值。由asp.net辅助进程来存储会话状态数据。
Off 禁用会话状态。
SQLServer 使用进程外SQL Server数据库保存会话状态数据。
StateServer 使用进程外 ASP.NET 状态服务存储状态信息。
一般默认情况下使用InProc模式来存储会话状态数据，这种模式的好处是存取速度快，缺点是比较占用内存，所以不宜在这种模式下存储大型的用户会话数据。

10.<globalization>节点：
用于配置应用程序的全球化设置。此节点有几个比较重要的属性，分别如下：
属性名说明
fileEncoding 可选属性。设置.aspx、.asmx 和 .asax 文件的存储编码。
requestEncoding 可选属性。设置客户端请求的编码，默认为UTF-8.
responseEncoding 可选属性。设置服务器端响应的编码，默认为UTF-8.
以下就是asp.net应用程序中的默认配置：

<globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8"/>

asp.net夜话之十一：web.config详解

　　在开发中经常会遇到这样的情况，在部署程序时为了保密起见并不将源代码随项目一同发布，而我们开发时的环境与部署环境可能不一致（比如数据库不一样），如果在代码中保存这些配置这些信息部署时需要到用户那里更改代码再重新编译，这种部署方式非常麻烦。

　　在.net中提供了一种便捷的保存项目配置信息的办法，那就是利用配置文件，配置文件的文件后缀一般是.config，在asp.net中配置文件名一般默认是web.config。每个web.config文件都是基于XML的文本文件，并且可以保存到Web应用程序中的任何目录中。在发布Web应用程序时web.config文件并不编译进dll文件中。如果将来客户端发生了变化，仅仅需要用记事本打开web.config文件编辑相关设置就可以重新正常使用，非常方便。

　　本篇要讲述的知识如下：

　　配置文件的查找优先级

　　配置文件节点说明

　　配置文件的操作

　　配置文件的查找优先级

　　在.net提供了一个针对当前机器的配置文件，这个文件是machine.config，它位于%windir%Microsoft.NETFrameworkv2.0.50727CONFIG文件下（%windir%是系统分区下的系统目录，在命令行模式下输入%windir%然后回车就能查看当前机器的系统目录，在Windows2003及WindowsXP中%windir%是系统分区下的windows目录，在Windows2000中%windir%是系统分区下的WinNT目录，在笔者机器上这个系统目录是C:WINDOWS）。这个文件里面定义了针对当前机器的WinForm程序和asp.net应用程序的配置。下面是machine.config文件的内容：

　　 asp.net夜话之十一：web.config详解

　　在这个文件夹下还有一个web.config文件，这个文件包含了asp.net网站的常用配置。下面是这个web.config文件的内容：

　　 asp.net夜话之十一：web.config详解

　　asp.net网站IIS启动的时候会加载配置文件中的配置信息，然后缓存这些信息，这样就不必每次去读取配置信息。在运行过程中asp.net应用程序会监视配置文件的变化情况，一旦编辑了这些配置信息，就会重新读取这些配置信息并缓存。

　　当我们要读取某个节点或者节点组信息时，是按照如下方式搜索的：

　　(1)如果在当前页面所在目录下存在web.config文件，查看是否存在所要查找的结点名称，如果存在返回结果并停止查找。

　　(2)如果当前页面所在目录下不存在web.config文件或者web.config文件中不存在该结点名，则查找它的上级目录，直到网站的根目录。

　　(3)如果网站根目录下不存在web.config文件或者web.config文件中不存在该节点名则在%windir%Microsoft.NETFrameworkv2.0.50727CONFIGweb.config文件中查找。

　　(4)如果在%windir%Microsoft.NETFrameworkv2.0.50727CONFIGweb.config文件中不存在相应结点，则在%windir%Microsoft.NETFrameworkv2.0.50727CONFIGmachine.config文件中查找。

　　(5)如果仍然没有找到则返回null。

　　所以如果我们对某个网站或者某个文件夹有特定要求的配置，可以在相应的文件夹下创建一个web.config文件，覆盖掉上级文件夹中的web.config文件中的同名配置即可。这些配置信息的寻找只查找一次，以后便被缓存起来供后来的调用。在asp.net应用程序运行过程中，如果web.config文件发生更改就会导致相应的应用程序重新启动，这时存储在服务器内存中的用户会话信息就会丢失（如存储在内存中的Session）。一些软件（如杀毒软件）每次完成对web.config的访问时就会修改web.config的访问时间属性，也会导致asp.net应用程序的重启。

　　配置文件节点说明

　　web.config文件是一个XML文件，它的根结点是<configuration>，在<configuration>节点下的常见子节点有：<configSections>、<appSettings>、<connectionStrings>和<system.web>。其中<appSettings>节点主要用于配置一些网站的应用配置信息，而<connectionStrings>节点主要用于配置网站的数据库连接字符串信息。

　　<system.web>节点主要是网站运行时的一些配置，它的常见节点有如下：

　　<appSettings>节点

　　<appSettings>节点主要用来存储asp.net应用程序的一些配置信息，比如上传文件的保存路径等，以下是一个例子：

<appSettings> 　　 　　<addkey="ImageType"value=".jpg;.bmp;.gif;.png;.jpeg"/> 　　 　　<addkey="FileType"value=".jpg;.bmp;.gif;.png;.jpeg;.pdf;.zip;.rar;.xls;.doc"/> </appSettings>

　　对于<appSettings>节点中的值可以按照key来进行访问，以下就是一个读取key值为“FileType”节点值的例子：

stringfileType=ConfigurationManager.AppSettings["FileType"];

　　<connectionStrings>节点

　　<connectionStrings>节点主要用于配置数据库连接的，我们可以<connectionStrings>节点中增加任意个节点来保存数据库连接字符串，将来在代码中通过代码的方式动态获取节点的值来实例化数据库连接对象，这样一旦部署的时候数据库连接信息发生变化我们仅需要更改此处的配置即可，而不必因为数据库连接信息的变化而需要改动程序代码和重新部署。

　　以下就是一个<connectionStrings>节点配置的例子：

<connectionStrings> 　　 　　<addname="AspNetStudyConnectionString1"connectionString="DataSource=(local);InitialCatalog=AspNetStudy;UserID=sa;Password=sa"/> </connectionStrings>

　　在代码中我们可以这么实例化数据库连接对象：

//读取web.config节点配置 stringconnectionString=ConfigurationManager.ConnectionStrings["AspNetStudyConnectionString1"].ConnectionString; //实例化SqlConnection对象 SqlConnectionconnection=newSqlConnection(connectionString);

　　这样做的好处是一旦开发时所用的数据库和部署时的数据库不一致，仅仅需要用记事本之类的文本编辑工具编辑connectionString属性的值就行了。

　　<compilation>节点

　　<compilation>节点配置 ASP.NET 使用的所有编译设置。默认的debug属性为“true”，即允许调试，在这种情况下会影响网站的性能，所以在程序编译完成交付使用之后应将其设为“false”。

　　<authentication>节点

　　设置asp.net身份验证模式，有四种身份验证模式，它们的值分别如下：

　　Mode说明

　　Windows使用Windows身份验证，适用于域用户或者局域网用户。

　　Forms使用表单验证，依靠网站开发人员进行身份验证。

　　Passport使用微软提供的身份验证服务进行身份验证。

　　None不进行任何身份验证。

　　<authentication>节点

　　<authentication>节点控制用户对网站、目录或者单独页的访问，必须配合<authentication>节点一起使用。

　　<customErrors>节点

　　<customErrors>节点用于定义一些自定义错误信息的信息。此节点有Mode和defaultRedirect两个属性，其中defaultRedirect属性是一个可选属性，表示应用程序发生错误时重定向到的默认URL，如果没有指定该属性则显示一般性错误。Mode属性是一个必选属性，它有三个可能值，它们所代表的意义分别如下：

　　Mode说明

　　On表示在本地和远程用户都会看到自定义错误信息。

　　Off禁用自定义错误信息，本地和远程用户都会看到详细的错误信息。

　　RemoteOnly表示本地用户将看到详细错误信息，而远程用户将会看到自定义错误信息。

　　这里有必要说明一下本地用户和远程用户的概念。当我们访问asp.net应用程时所使用的机器和发布asp.net应用程序所使用的机器为同一台机器时成为本地用户，反之则称之为远程用户。在开发调试阶段为了便于查找错误Mode属性建议设置为Off，而在部署阶段应将Mode属性设置为On或者RemoteOnly，以避免这些详细的错误信息暴露了程序代码细节从而引来黑客的入侵。

　　下面我们添加一个页面CustomErrorsDemo.aspx，在它的Page_Load事件里抛出一个异常，代码如下：

usingSystem; usingSystem.Data; usingSystem.Configuration; usingSystem.Collections; usingSystem.Web; usingSystem.Web.Security; usingSystem.Web.UI; usingSystem.Web.UI.WebControls; usingSystem.Web.UI.WebControls.WebParts; usingSystem.Web.UI.HtmlControls; publicpartialclassCustomErrorsDemo:System.Web.UI.Page { 　　protectedvoidPage_Load(objectsender,EventArgse) 　　{ 　　　　thrownewException("故意抛出的异常。"); 　　} }

　　我们先配置<customErrors>如下：

<customErrorsmode="RemoteOnly"> 　　<errorstatusCode="403"redirect="NoAccess.htm"/> 　　<errorstatusCode="404"redirect="FileNotFound.htm"/> </customErrors>

　　这时本地运行CustomErrorsDemo.aspx的效果如下：

　　 asp.net夜话之十一：web.config详解

　　远程访问时看到的效果：

　　 asp.net夜话之十一：web.config详解

　　如果我们将customErrors的Mode属性设置为“On”本地运行和远程访问都会看到如下效果：

　　 asp.net夜话之十一：web.config详解

　　如果将customErrors的Mode属性设置为“Off”本地运行和远程访问都会看到如下效果：

　　 asp.net夜话之十一：web.config详解

　　<error>子节点

　　在<customErrors>节点下还包含有<error>子节点，这个节点主要是根据服务器的HTTP错误状态代码而重定向到我们自定义的错误页面，注意要使<error>子节点下的配置生效，必须将<customErrors>节点节点的Mode属性设置为“On”。下面是一个例子：

<customErrorsmode="On"defaultRedirect="GenericErrorPage.htm"> 　　<errorstatusCode="403"redirect="403.htm"/> 　　<errorstatusCode="404"redirect="404.htm"/> </customErrors>

　　在上面的配置中如果用户访问的页面不存在就会跳转到404.htm页面，如果用户没有权限访问请求的页面则会跳转到403.htm页面，403.htm和404.htm页面都是我们自己添加的页面，我们可以在页面中给出友好的错误提示。

　　<httpHandlers>节点

　　<httpHandlers>节点用于根据用户请求的URL和HTTP谓词将用户的请求交给相应的处理程序。可以在配置级别的任何层次配置此节点，也就是说可以针对某个特定目录下指定的特殊文件进行特殊处理。

　　下面是与machine.config文件同一目录下的web.config文件中的<httpHandlers>节点配置：

　　从上面的配置中可以看出，针对*.mdf、*.ldf文件的Get或者Post请求都会交给System.Web.HttpForbiddenHandler来处理，处理的结果就是用户不能查看或者下载相关的文件。如果我们某个文件夹下的文件或者某个类型的文件不允许用户下载，可以在</httpHandlers>节点中增加相应的子节点。

　　下面我们以一个例子来说明<httpHandlers>节点的用法，在我们的asp.net应用程序中建立一个IPData目录，在IPData目录中创建一个IPData.txt文件，然后在Web.config中添加以下配置：

<httpHandlers> 　　　<addpath="IPData/*.txt"verb="*"type="System.Web.HttpForbiddenHandler"/> </httpHandlers>

　　上面的代码的作用是禁止访问IPData目录下的任何txt文件。

　　然后新建一个页面，在页面中添加一个超级链接，链接到该目录下IPData.txt文件，代码如下：

<%@PageLanguage="C#"AutoEventWireup="true"CodeFile="HttpHandlersDemo.aspx.cs"Inherits="HttpHandlersDemo"%> <!DOCTYPEhtmlPUBLIC"-//W3C//DTDXHTML1.0Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <htmlxmlns="http://www.w3.org/1999/xhtml"> <headrunat="server"> 　　<title>httpHandlers节点的例子</title> </head> <body> 　　<formid="form1"runat="server"> 　　<div> 　　<ahref="IPData/IPData.txt"title="打开IPData/IPData.txt">打开IPData/IPData.txt</a> 　　</div> 　　</form> </body> </html>

　　运行这个页面的效果如下：

　　 asp.net夜话之十一：web.config详解

　　当前web.config文件的<customErrors>节点配置如下：

<customErrors mode="On" defaultRedirect="GenericErrorPage.htm"> 　　 <error statusCode="403" redirect="403.htm" /> 　　 <error statusCode="404" redirect="404.htm" /> </customErrors>如果存在403.htm和404.htm页面，点击超级链接之后会出现如下效果：

　　 asp.net夜话之十一：web.config详解

　　我们从上图中可以看到当<customErrors>节点的Mode属性为“On”时，因为被禁止访问IPData文件夹下的所有txt文件，所以会跳转到自定义的没有权限提示页面，即403.htm。

　　<httpRuntime>节点

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

　　例如下面的配置控制用户最大能上传的文件为40M（40*1024K），最大超时时间为60秒，最大并发请求为100个。

<httpRuntimemaxRequestLength="40960"executionTimeout="60"appRequestQueueLimit="100"/>

　　<pages>节点

　　<pages>节点用于表示对特定页设置，主要有三个属性，分别如下：

　　属性名说明

　　buffer是否启用了 HTTP 响应缓冲。

　　enableViewStateMac是否应该对页的视图状态运行计算机身份验证检查 (MAC)，以放置用户篡改，默认为false，如果设置为true将会引起性能的降低。

　　validateRequest是否验证用户输入中有跨站点脚本攻击和SQL注入式漏洞攻击，默认为true，如果出现匹配情况就会发 HttpRequestValidationException 异常。对于包含有在线文本编辑器页面一般自行验证用户输入而将此属性设为false。

　　下面就是一个配置节点的例子：

<pagesbuffer="true"enableViewStateMac="true"validateRequest="false"/>

　　<sessionState>节点

　　<sessionState>节点用于配置当前asp.net应用程序的会话状态配置。以下就是一个常见配置：

<sessionStatecookieless="false"mode="InProc"timeout="30"/>

　　上面的节点配置是设置在asp.net应用程序中启用Cookie，并且指定会话状态模式为在进程中保存会话状态，同时还指定了会话超时为30分钟。

　　<sessionState>节点的Mode属性可以是以下几种值之一：

　　属性值说明

　　Custom使用自定义数据来存储会话状态数据。

　　InProc默认值。由asp.net辅助进程来存储会话状态数据。

　　Off禁用会话状态。

　　SQLServer使用进程外SQL Server数据库保存会话状态数据。

　　StateServer使用进程外 ASP.NET 状态服务存储状态信息。

　　一般默认情况下使用InProc模式来存储会话状态数据，这种模式的好处是存取速度快，缺点是比较占用内存，所以不宜在这种模式下存储大型的用户会话数据。

　　<globalization>节点：

GoodShot

关注

0
点赞
踩
4

收藏

觉得还不错? 一键收藏
0
评论
web.config详解

web.config详解(配置文件节点说明） (另外，参见http://blog.csdn.net/goodshot/article/details/8510550)web.config文件是一个XML文件，它的根结点是，在节点下的常见子节点有：、、和。其中节点主要用于配置一些网站的应用配置信息，而节点主要用于配置网站的数据库连接字符串信息。节点
复制链接

扫一扫