ASP.NET中的Web.config应用程序配置文件简介

关注

转载最新推荐文章于 2026-03-23 00:34:20 发布 2.7k 阅读 AI 写同款· GEO 优化 ›

asp.net Web.config 详细配置说明 asp.net开发的朋友，经常用得到web.config文件的配置，所以我们特整理了中文说明。立即下载

转贴：http://hi.baidu.com/raincloud_msn/blog/item/36f7201ff7269364f624e48d.html

Web.config文件是一个标准的XML文档，所有的配置信息都位于<configuration>标记内。<system.web>标记内则包含了核心ASP.NET配置设置。用户可以在Visual Studio.NET中打开Web.config来查看和编辑它的内容，这个文件中包含了大量的注释信息，用户可以参照学习。下面介绍几个常用的标记。

1. <appSettings>标记

这个标记用来配置自定义的应用程序设置，比如数据库连接字符串、文件路径或存在在应用程序.ini文件中的任何信息。用户可以使用System.Configuration.ConfigurationSettings类在代码中访问<appSettings>标记中指定的键/值对。

另外，用户还可以在Web.config文件的<appSettings>标记中使用file属性。这个属性指定了一个配置文件，该文件提供附加设置或者重写<appSettings>标记中指定的设置。当使用file属性指定配置文件时，必须要把<appSettings>作为根节点，而不是<configuration>。

在下面的配置中，我们添加了一个连接字符串配置，配置名称为ConnString，值为“server=localhost;database=test;uid=testing;pwd=test;”。

</appSettings>
用户就可以在页面中使用下面的代码来访问新添加的设置。

ConfigurationSettings.AppSettings("ConnString");

remove子元素用来删除特定的设置；clear子元素用来删除包含它的appSettings中的所有设置。例如：

</appSettings>

2. <authentication>和<authorization>标记

这两个标记紧密相关，它们用来设置应用程序的安全性。

<authentication>标记用来定义应用程序使用的身份验证方法和参数。它包含一个mode属性和两个子标记（<forms>和<passport>）。mode属性用来控制应用程序的默认身份验证模式，共有4种模式。

Windows：将Windows验证指定为默认的身份验证模式。当使用以下任意形式的Microsoft Internet信息服务（IIS）身份验证时使用该模式：基本、简要、集成的Windows验证（MTLM/Kerberos）或证书。

Forms：将ASP.NET基于窗体的身份验证指定为默认的身份验证模式。

Passport：将Microsoft Passport身份验证指定为默认的身份验证模式。

None：不指定任何身份验证。只有匿名用户是预期的或者应用程序可以处理事件以提供其自身的身份验证。<forms>子标记用来为基于窗体的自定义身份验证配置ASP.NET应用程序。比如指定密码是明文还是使用散列算法进行加密，用来在浏览器请求之间维持认证的Cookie名字，用于未授权请求的登录URL，以及指定保护级别等。

<authorization>标记用来设置应用程序的授权策略，它控制对URL资源的客户端访问。在这个标记下存在两个子标记：<allow>和<deny>。其中，<allow>用来允许对资源的访问；<deny>用来拒绝对资源的访问。

在运行时，ASP.NET将在<authorization>标记中查找<allow>和<deny>标记，直到它找到适合特定用户的第一个访问规则。然后，它根据找到的第一项访问规则是<allow>还是<deny>规则，来允许或拒绝对URL资源的访问。Machine.config文件中的默认身份验证规则是<allow users="*" />，因此除非另行配置，否则在默认情况下会允许访问。

在下面的示例中，使用mode属性指定使用基于窗体的身份验证，并在<form>子标记中指定了传输来自客户端的登录信息的Cookie名称，以及当初始身份验证失败时所使用的登录页的名称。必须将<authorization>节包含在内才能要求所有用户进行Forms身份验证，本例中使用<deny users="?" />拒绝对站点的所有匿名用户访问。

<system.web>

</authentication>

</authorization>

</system.web>

</configuration>

3. <customErrors>标记

这个标记用来配置自定义错误信息。例如：

</customErrors>

该标记中包含一个mode属性和一个可选属性defaultRedirect。Mode属性用来指定如何处理自定义错误，具有三个可选值。

On：指定启用自定义错误。如果未指定defaultRedirect，用户将看到一般性错误。

Off：指定禁用自定义错误。这时将始终显示ASP.NET的详细错误信息页面。

RemoteOnly：指定仅向远程客户端显示自定义错误，并且向本地主机显示ASP.NET错误。这是默认选项。
defaultRedirect属性指定发生错误时钭显示的URL。如果未指定defaultRecirect，将显示一般性错误。URL可以是绝对路径，也可以是路径。相对URL是相对于指定了defaultRedirect URL的Web.config文件，而不是相对于发生了错误的Web页。以~开头的URL（例如~/ErrorPage.htm）表示指定的URL是相对于应用程序的根路径。

另外，<customError>标记中还包含一个<error>子标记，它用来定义自定义错误条件，并且用户可以使用它指定多个自定义错误条件。

下面给出了一个示例。

<system.web>

</customErrors>

</system.web>

</configuration>

4. <identity>标记

这个标记用来控制Web应用程序的应用程序标识，它可以在任何级别（计算机、站点、应用程序、子目录或页）上声明。

这个标记中包含一个必选属性impersonate，它用来指定是否对每个请求使用客户端模拟。

<identity>标记还包含两个可选属性：userName和password。它们指定如果impersonate设置为true，则使用用户名和密码。userName和password以明文形式存储在配置文件，例如，通过在包含服务器的域上具有适当凭据的、已经过身份验证的用户来访问。为了增强安全性，<identity>标记支持在注册表中存储加密userName和password属性。凭据必须是用Windows 2000和Windows XP数据保护API（DPAPI）加密函数加密的REG_BINARY格式。要加密用户名和密码，并将它们存储在注册表中，请如下设置userName和password。