认识ASP.NET配置文件Web.config

一、认识Web.config文件
　　Web.config文件是一个XML文本文件，它用来储存 ASP.NET Web 应用程序的配置信息（如最常用的设置ASP.NET Web 应用程序的身份验证方式），它可以出现在应用程序的每一个目录中。当你通过VB.NET新建一个Web应用程序后，默认情况下会在根目录自动创建一个默认的 Web.config文件，包括默认的配置设置，所有的子目录都继承它的配置设置。如果你想修改子目录的配置设置，你可以在该子目录下新建一个Web.config文件。它可以提供除从父目录继承的配置信息以外的配置信息，也可以重写或修改父目录中定义的设置。
　　在运行时对Web.config文件的修改不需要重启服务就可以生效（注：＜processModel＞ 节例外）。当然Web.config文件是可以扩展的。你可以自定义新配置参数并编写配置节处理程序以对它们进行处理。

二、web.config配置文件

（默认的配置设置）以下所有的代码都应该位于

＜configuration＞ ＜system.web＞

　　

和

＜/system.web＞ ＜/configuration＞

　　

之间，出于学习的目的下面的示例都省略了这段XML标记。

1、<appSetings>
作用：<appSettings>节点主要用来存储asp.net应用程序的一些配置信息，比如上传文件的保存路径等

示例：
<appSettings>
<add key="ImageType" value=".jpg;.bmp;.gif;.png;.jpeg"/> <!--允许上传的图片格式类型-->
</appSettings>

后台访问：
string fileType=ConfigurationManager.AppSettings["FileType "];

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

示例：
<connectionStrings>
<add name="AspNetStudyConnectionString1" connectionString="Data Source=(local);Initial Catalog=AspNetStudy;User ID=sa;Password=sa"/>
</connectionString>
后台访问：
string connectionString = ConfigurationManager.ConnectionStrings["AspNetStudyConnectionString1"].ConnectionString;

　　3、＜authentication＞
　　作用：配置 ASP.NET 身份验证支持（为Windows、Forms、PassPort、None四种）。 它们的值分别如下：
Windows 使用Windows身份验证，适用于域用户或者局域网用户。
Forms 使用表单验证，依靠网站开发人员进行身份验证。
Passport 使用微软提供的身份验证服务进行身份验证。
None 不进行任何身份验证。

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

　　示例：
　　以下示例为基于窗体（Forms）的身份验证配置站点，当没有登陆的用户访问需要身份验证的网页，网页自动跳转到登陆网页。

＜authentication mode="Forms" ＞ ＜forms loginUrl="logon.aspx" name=".FormsAuthCookie"/＞ ＜/authentication＞

　　

其中元素loginUrl表示登陆网页的名称，name表示Cookie名称

　　4、＜authorization＞
　　作用：控制对 URL 资源的客户端访问（如允许匿名用户访问）。此元素可以在任何级别（计算机、站点、应用程序、子目录或页）上声明。必需与＜authentication＞ 节配合使用。
　　示例：

以下示例禁止匿名用户的访问

＜authorization＞ 　＜deny users="?"/＞ ＜/authorization＞

　　

注：你可以使用user.identity.name来获取已经过验证的当前的用户名；可以使用 web.Security.FormsAuthentication.RedirectFromLoginPage方法将已验证的用户重定向到用户刚才请求的页面.具体的实例请参考:
　　Forms验证 http://www.fanvb.net/websample/dataauth.aspx
　　5、＜compilation＞
　　作用：配置 ASP.NET 使用的所有编译设置。默认的debug属性为“True”.在程序编译完成交付使用之后应将其设为True（Web.config文件中有详细说明，此处省略示例）

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

当发生错误时，将网页跳转到自定义的错误页面。

＜customErrors defaultRedirect="ErrorPage.aspx" mode="RemoteOnly"＞ ＜/customErrors＞

　　

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

7、<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>

8、<httpHandlers>

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

示例：

<httpHandlers><add path="*.rules" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.xoml" verb="*" type="System.ServiceModel.Activation.HttpHandler, System.ServiceModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" validate="false"/> <add path="trace.axd" verb="*" type="System.Web.Handlers.TraceHandler" validate="true"/> <add path="WebResource.axd" verb="GET" type="System.Web.Handlers.AssemblyResourceLoader" validate="true"/> <add path="*.axd" verb="*" type="System.Web.HttpNotFoundHandler" validate="true"/> <add path="*.aspx" verb="*" type="System.Web.UI.PageHandlerFactory" validate="true"/> <add path="*.ashx" verb="*" type="System.Web.UI.SimpleHandlerFactory" validate="true"/> <add path="*.asmx" verb="*" type="System.Web.Services.Protocols.WebServiceHandlerFactory, System.Web.Services, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" validate="false"/> <add path="*.rem" verb="*" type="System.Runtime.Remoting.Channels.Http.HttpRemotingHandlerFactory, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" validate="false"/> <add path="*.soap" verb="*" type="System.Runtime.Remoting.Channels.Http.HttpRemotingHandlerFactory, System.Runtime.Remoting, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" validate="false"/> <add path="*.asax" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.ascx" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.master" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.skin" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.browser" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.sitemap" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.dll.config" verb="GET,HEAD" type="System.Web.StaticFileHandler" 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"/> <add path="*.cs" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.csproj" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.vb" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.vbproj" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.webinfo" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.licx" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.resx" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.resources" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.mdb" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.vjsproj" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.java" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.jsl" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.ldb" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.ad" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.dd" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.ldd" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.sd" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.cd" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.adprototype" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.lddprototype" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.sdm" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.sdmDocument" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.mdf" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.ldf" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.exclude" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.refresh" verb="*" type="System.Web.HttpForbiddenHandler" validate="true"/> <add path="*.svc" verb="*" type="System.ServiceModel.Activation.HttpHandler, System.ServiceModel, Version=3.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" validate="false"/> <add path="*" verb="GET,HEAD,POST" type="System.Web.DefaultHttpHandler" validate="true"/> <add path="*" verb="*" type="System.Web.HttpMethodNotAllowedHandler" validate="true"/>

</httpHandlers>

从上面的配置中可以看出，针对*.mdf、*.ldf文件的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>

　　9、＜httpRuntime＞
　　作用：配置 ASP.NET HTTP 运行库设置。该节可以在计算机、站点、应用程序和子目录级别声明。
　　示例：

控制用户上传文件最大为4M，最长时间为60秒，最多请求数为100

＜httpRuntime maxRequestLength="4096" executionTimeout="60" appRequestQueueLimit="100"/＞

　　

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

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

　　示例：不检测用户在浏览器输入的内容中是否存在潜在的危险数据（注：该项默认是检测，如果你使用了不检测，一要对用户的输入进行编码或验证)，在从客户端回发页时将检查加密的视图状态，以验证视图状态是否已在客户端被篡改。(注：该项默认是不验证）

＜pages buffer="true" enableViewStateMac="true" validateRequest="false"/＞

　　

11、＜sessionState＞
　　作用：为当前应用程序配置会话状态设置（如设置是否启用会话状态，会话状态保存位置）。
　　示例：

＜sessionState mode="InProc" cookieless="true" timeout="20"/＞ ＜/sessionState＞

　　

注：

<sessionState>节点的Mode属性可以是以下几种值之一：
Custom 使用自定义数据来存储会话状态数据。
InProc 默认值。由asp.net辅助进程来存储会话状态数据。
Off 禁用会话状态。
SQLServer 使用进程外SQL Server数据库保存会话状态数据。
StateServer 使用进程外 ASP.NET 状态服务存储状态信息。
一般默认情况下使用InProc模式来存储会话状态数据，这种模式的好处是存取速度快，缺点是比较占用内存，所以不宜在这种模式下存储大型的用户会话数据
　　mode="InProc"表示：在本地储存会话状态（你也可以选择储存在远程服务器或SAL服务器中或不启用会话状态）
　　cookieless="true"表示：如果用户浏览器不支持Cookie时启用会话状态(默认为False）
　　timeout="20"表示：会话可以处于空闲状态的分钟数

12、<globalization>

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

示例：
以下就是asp.net应用程序中的默认配置：
<globalization fileEncoding="utf-8" requestEncoding="utf-8" responseEncoding="utf-8"/>

　　13、＜trace＞
　　作用：配置 ASP.NET 跟踪服务，主要用来程序测试判断哪里出错。
　　示例：

以下为Web.config中的默认配置：

＜trace enabled="false" requestLimit="10" pageOutput="false" traceMode="SortByTime" localOnly="true" /＞

　

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

三、自定义Web.config文件配置节
　　自定义Web.config文件配置节过程分为两步。
　　一是在在配置文件顶部 ＜configSections＞ 和 ＜/configSections＞标记之间声明配置节的名称和处理该节中配置数据的 .NET Framework 类的名称。
　　二是在 ＜configSections＞ 区域之后为声明的节做实际的配置设置。
　　示例：创建一个节存储数据库连接字符串

＜configuration＞ 　＜configSections＞ 　＜section name="appSettings" type="System.Configuration.NameValueFileSectionHandler, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/＞ ＜/configSections＞ 　＜appSettings＞ 　　＜add key="scon" value="server=a;database=northwind;uid=sa;pwd=123"/＞ 　＜/appSettings＞ 　＜system.web＞ 　　...... 　＜/system.web＞ ＜/configuration＞

　　四、访问Web.config文件
　　你可以通过使用ConfigurationSettings.AppSettings 静态字符串集合来访问 Web.config 文件示例：获取上面例子中建立的连接字符串。

Dim sconstr As String = ConfigurationSettings.AppSettings("SconStr") Dim scon = New SqlConnection(sconstr)