欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Web.config(应用程序的配置信息)总结

程序员文章站 2024-03-05 17:14:49
web.config文件是一个xml文本文件,它用来储存 asp.net web 应用程序的配置信息(如最常用的设置asp.net web 应用程序的身份验证方式),它可以...
web.config文件是一个xml文本文件,它用来储存 asp.net web 应用程序的配置信息(如最常用的设置asp.net web 应用程序的身份验证方式),它可以出现在应用程序的每一个目录中。当你通过.net新建一个web应用程序后,默认情况下会在根目录自动创建一个默认的web.config文件,包括默认的配置设置,所有的子目录都继承它的配置设置。如果你想修改子目录的配置设置,你可以在该子目录下新建一个web.config文件。它可以提供除从父目录继承的配置信息以外的配置信息,也可以重写或修改父目录中定义的设置。

在运行时对web.config文件的修改不需要重启服务就可以生效(注: 节例外)。当然web.config文件是可以扩展的。你可以自定义新配置参数并编写配置节处理程序以对它们进行处理。
复制代码 代码如下:

<?xml version="1.0"?>
<configuration>
<!--指定配置节和命名空间声明。clear:移除对继承的节和节组的所有引用,只允许由当前 section 和 sectiongroup 元素添加的节和节组。remove:移除对继承的节和节组的引用。section:定义配置节处理程序与配置元素之间的关联。sectiongroup:定义配置节处理程序与配置节之间的关联。-->
<configsections>
<sectiongroup name="system.web.extensions" type="system.web.configuration.systemwebextensionssectiongroup, system.web.extensions, version=1.0.61025.0, culture=neutral, publickeytoken=31bf3856ad364e35">
<sectiongroup name="scripting" type="system.web.configuration.scriptingsectiongroup, system.web.extensions, version=1.0.61025.0, culture=neutral, publickeytoken=31bf3856ad364e35">
<section name="scriptresourcehandler" type="system.web.configuration.scriptingscriptresourcehandlersection, system.web.extensions, version=1.0.61025.0, culture=neutral, publickeytoken=31bf3856ad364e35" requirepermission="false" allowdefinition="machinetoapplication"/>
</sectiongroup>
</sectiongroup>
<section name="rewriter" type="intelligencia.urlrewriter.configuration.rewriterconfigurationsectionhandler, intelligencia.urlrewriter"/>
</configsections>
<!--appsettings是应用程序设置,可以定义应用程序的全局常量设置等信息。-->
<appsettings>
<add key="errpage" value="http://www.cnblogs.com"/>
</appsettings>
<!--连接字符串设置-->
<connectionstrings>
<add name="sqlconnectionstring" connectionstring=""/>
</connectionstrings>
<!--指定应用子配置设置的资源,并锁定配置设置,以防止它们被子配置文件重写。path指定应用包含的配置设置的资源。allowoverride是否允许配置文件的重写,提高配置文件的安全性。-->
<location path="default.aspx" allowoverride="false">
<!--控制asp.net运行时的行为-->
<system.web>
<!--identity控制web应用程序的身份验证标识.-->
<identity impersonate="false" />
<!--标识特定于页的配置设置(如是否启用会话状态、视图状态,是否检测用户的输入等)。<pages>可以在计算机、站点、应用程序和子目录级别声明。
masterpagefile:默认主页为index。
theme:主题是default。
buffer:指定 url 资源是否使用响应缓冲。默认值为 true。
enableviewstatemac:指定从客户端回发页时,asp.net 是否应该对页的视图状态运行消息身份验证代码 (mac)。如果为 true,将检查加密的视图状态,以验证视图状态是否已在客户端被篡改。默认值为 true。
validaterequest:指示 asp.net 在从浏览器输入的所有内容中检查是否存在潜在的危险数据。如果是 true,则通过将所有输入数据与一个潜在危险值列表进行比较来执行请求验证。如果发生匹配,asp.net 将引发 httprequestvalidationexception 异常。默认值为 true。
enableviewstate:指定视图状态是否启用并在多个页请求之间保持。默认值为 true。-->
<pages masterpagefile="index" theme="default" buffer="true" enableviewstatemac="true" validaterequest="false" enableviewstate="false">
<!--controls 元素定义标记前缀所在的 register 指令和命名空间的集合-->
<controls></controls>
<!--将在程序集预编译期间使用的导入指令的集合-->
<namespaces></namespaces>
</pages>
<!--默认错误页设置。
mode:具有on,off,remoteonly 3种状态。on表示始终显示自定义的信息; off表示始终显示详细的asp.net错误信息; remoteonly表示只对不在本地web服务器上运行的用户显示自定义信息。
defaultredirect:用于出现错误时重定向的url地址。-->
<customerrors defaultredirect="err.html" mode="remoteonly">
<!--特殊代码编号的错误从定向文件-->
<error statuscode="403" redirect="noaccess.htm" />
<error statuscode="404" redirect="filenotfound.htm" />
</customerrors>
<!--配置调试和跟踪。
enabled:是否为应用程序启用跟踪。默认值为 false。
localonly:指定跟踪查看器 (trace.axd) 是否只用于主机 web 服务器。如果是 false,则跟踪查看器可用于任何计算机。默认情况下,trace.axd 查看器被添加到 httphandlers 元素。默认值为 true。
pageoutput:指定在每一页的结尾是否呈现跟踪输出。如果是 false,则只能通过跟踪实用工具访问跟踪输出。默认值为 false。
requestlimit:指定在服务器上存储的跟踪请求的数目。如果达到限制,并且 mostrecent 特性为 false,将自动禁用跟踪。最大请求限制为 10,000。如果指定了大于 10,000 的值,asp.net 会在不给出任何提示的情况下将它向下舍入到 10,000。默认值为 10。
tracemode:指定显示跟踪信息的顺序。tracemode 特性可以为下列可能值之一。
值 说明
sortbycategory 指定根据用户定义的类别按字母顺序显示跟踪信息。 sortbytime 指定以处理跟踪信息的顺序来显示跟踪信息。
默认值为 sortbytime。-->
<trace enabled="true" localonly="false" pageoutput="true" requestlimit="15" tracemode="sortbycategory"/>
<!-- 设置 compilation debug="true" 将调试符号插入已编译的页面中。但由于这会影响性能,因此只在开发过程中将此值设置为 true。设置默认的开发语言c#。batch是否支持批处理-->
<compilation debug="true" defaultlanguage="c#" batch="false">
<assemblies>
<!--加的程序集引用,每添加一个程序集,就表示你的应用程序已经依赖了一个程序集,你就可以在你的应用程序中使用了-->
<add assembly="system.web.extensions, version=1.0.61025.0, culture=neutral, publickeytoken=31bf3856ad364e35"/>
<add assembly="system.design, version=2.0.0.0, culture=neutral, publickeytoken=b03f5f7f11d50a3a"/>
<add assembly="system.web.extensions.design, version=1.0.61025.0, culture=neutral, publickeytoken=31bf3856ad364e35"/>
<add assembly="system.windows.forms, version=2.0.0.0, culture=neutral, publickeytoken=b77a5c561934e089"/>
<add assembly="system.web, version=2.0.0.0, culture=neutral, publickeytoken=b03f5f7f11d50a3a"/>
<add assembly="system, version=2.0.0.0, culture=neutral, publickeytoken=b77a5c561934e089"/>
<add assembly="system.xml, version=2.0.0.0, culture=neutral, publickeytoken=b77a5c561934e089"/>
<add assembly="system.drawing, version=2.0.0.0, culture=neutral, publickeytoken=b03f5f7f11d50a3a"/>
<add assembly="system.data, version=2.0.0.0, culture=neutral, publickeytoken=b77a5c561934e089"/>
<add assembly="system.web.services, version=2.0.0.0, culture=neutral, publickeytoken=b03f5f7f11d50a3a"/>
<add assembly="system.configuration, version=2.0.0.0, culture=neutral, publickeytoken=b03f5f7f11d50a3a"/>
</assemblies>
<!--定义用于编译自定义资源文件的生成提供程序的集合。-->
<buildproviders>
<add extension=".aspx" type="system.web.compilation.pagebuildprovider"/>
<add extension=".ascx" type="system.web.compilation.usercontrolbuildprovider"/>
<add extension=".master" type="system.web.compilation.masterpagebuildprovider"/>
<add extension=".asmx" type="system.web.compilation.webservicebuildprovider"/>
<add extension=".ashx" type="system.web.compilation.webhandlerbuildprovider"/>
<add extension=".soap" type="system.web.compilation.webservicebuildprovider"/>
<add extension=".resx" type="system.web.compilation.resxbuildprovider"/>
<add extension=".resources" type="system.web.compilation.resourcesbuildprovider"/>
<add extension=".wsdl" type="system.web.compilation.wsdlbuildprovider"/>
<add extension=".xsd" type="system.web.compilation.xsdbuildprovider"/>
<add extension=".rdlc" type="microsoft.reporting.rdlbuildprovider, microsoft.reportviewer.common, version=8.0.0.0, culture=neutral, publickeytoken=b03f5f7f11d50a3a"/>
</buildproviders>
</compilation>
<!--通过 <authentication> 节可以配置 asp.net 使用的 安全身份验证模式,以标识传入的用户。windows: 使用iis验证方式。forms: 使用基于窗体的验证方式。passport: 采用passport cookie验证模式。none: 不采用任何验证方式。-->
<authentication mode="forms">
<!--name: 指定完成身份验证的http cookie的名称。
loginurl: 如果未通过验证或超时后重定向的页面url,一般为登录页面,让用户重新登录。
protection: 指定 cookie数据的保护方式。可设置为:all表示加密数据,并进行有效性验证两种方式,none表示不保护cookie,encryption表示对cookie内容进行加密,validation表示对cookie内容进行有效性验证。
timeout: 指定cookie的失效时间。超时后要重新登录。-->
<forms name=".aspxuserdemo" loginurl="login.aspx" protection="all" timeout="30"/>
</authentication>
<!--控制对 url 资源的客户端访问(如允许匿名用户访问)。此元素可以在任何级别(计算机、站点、应用程序、子目录或页)上声明。必需与<authentication> 节配合使用。此处的意思是对匿名用户不进行身份验证。拒绝用户weipeng-->
<authorization>
<allow users="*"/>
<deny users="weipeng"/>
<allow users="aa" roles="aa" />
</authorization>
<!--站点全球化设置,requestencoding: 它用来检查每一个发来请求的编码。responseencoding: 用于检查发回的响应内容编码.fileencoding:用于检查aspx,asax等文件解析的默认编码,默认的编码是utf-8-->
<globalization requestencoding="gb2312" responseencoding="gb2312" fileencoding="gb2312" />
<!--会话状态设置。
mode: 分为off,inproc,stateserver,sqlserver几种状态。mode ="inproc" 存储在进程中,特点:具有最佳的性能,速度最快,但不能跨多台服务器存储共享。mode = "stateserver" 存储在状态服务器中特点:当需要跨服务器维护用户会话信息时,使用此方法。但是信息存储在状态服务器上,一旦状态服务器出现故障,信息将丢失。mode="sqlserver" 存储在sql server中特点:工作负载会变大,但信息不会丢失。
stateconnectionstring:指定asp.net应用程序存储远程会话状态的服务器名,默认为本机。
sqlconnectionstring:当用会话状态数据库时,在这里设置连接字符串。
cookieless:设置为flase时,表示使用cookie会话状态来标识客户。
timeout:表示会话超时时间。-->
<sessionstate mode="inproc" stateconnectionstring="tcpip=127.0.0.1:42424" sqlconnectionstring="data source=127.0.0.1;trusted_connection=yes" cookieless="false" timeout="20"></sessionstate>
<!--为 asp.net 应用程序配置页的视图状态设置。设置要存储在页历史记录中的项数。-->
<sessionpagestate historysize="9"/>
<!--配置asp.net http运行库的设置。可以在计算机,站点,应用程序和子目录级别声明允许最多的请求个数100,最长允许执行请求时间为80秒,控制用户上传文件的大小,默认是4m。usefullyqualifiedredirecturl客户端重定向不需要被自动转换为完全限定格式。-->
<httpruntime apprequestqueuelimit="100" executiontimeout="80" maxrequestlength="40960" usefullyqualifiedredirecturl="false"/>
<!--httpmodules在一个应用程序内配置 http 模块。-->
<httpmodules>
<add name="outputcache" type="system.web.caching.outputcachemodule" />
<add name="session" type="system.web.sessionstate.sessionstatemodule" />
<add name="windowsauthentication" type="system.web.security.windowsauthenticationmodule" />
<add name="formsauthentication" type="system.web.security.formsauthenticationmodule" />
<add name="passportauthentication" type="system.web.security.passportauthenticationmodule" />
<add name="rolemanager" type="system.web.security.rolemanagermodule" />
<add name="urlauthorization" type="system.web.security.urlauthorizationmodule" />
<add name="fileauthorization" type="system.web.security.fileauthorizationmodule" />
<add name="anonymousidentification" type="system.web.security.anonymousidentificationmodule" />
<!--自定义的url重写,type基本上就是dll名-->
<add name="urlrewriter" type="intelligencia.urlrewriter.rewriterhttpmodule, intelligencia.urlrewriter" />
<add name="profile" type="system.web.profile.profilemodule" />
</httpmodules>
<!--httphandlers用于根据用户请求的url和http谓词将用户的请求交给相应的处理程序。可以在配置级别的任何层次配置此节点,也就是说可以针对某个特定目录下指定的特殊文件进行特殊处理。
add:指定映射到处理程序的谓词/路径。
clear:移除当前已配置或已继承的所有处理程序映射。
remove:移除映射到处理程序的谓词/路径。remove 指令必须与前一个 add 指令的谓词/路径组合完全匹配。该指令不支持通配符。-->
<httphandlers>
<remove verb="*" path="*.asmx"/>
<add verb="*" path="*.asmx" validate="false" type="system.web.script.services.scripthandlerfactory, system.web.extensions, version=1.0.61025.0, culture=neutral, publickeytoken=31bf3856ad364e35"/>
<add verb="*" path="*_appservice.axd" validate="false" type="system.web.script.services.scripthandlerfactory, system.web.extensions, version=1.0.61025.0, culture=neutral, publickeytoken=31bf3856ad364e35"/>
<add verb="get,head" path="scriptresource.axd" type="system.web.handlers.scriptresourcehandler, system.web.extensions, version=1.0.61025.0, culture=neutral, publickeytoken=31bf3856ad364e35" validate="false"/>
<add verb="post,get" path="ajaxpro/*.ashx" type="ajaxpro.ajaxhandlerfactory, ajaxpro.2"/>
</httphandlers>
<!--为 web 应用程序使用的 cookie 配置属性。
domain:设置 cookie 域名。
httponlycookies:在 internet explorer 6 sp1 中启用 httponlycookies cookie 的输出。默认值为 false。
requiressl:获取一个指示是否需要安全套接字层 (ssl) 通信的值.-->
<httpcookies httponlycookies="false" requiressl="false"/>
<!--控制 asp.net web 服务及其客户端的行为。
protocols:指定传输协议,asp.net 可使用这些传输协议来解密 http-->
<webservices>
<protocols>
<add/>
</protocols>
</webservices>
<!--为 web 应用程序配置缓存设置。
cache:定义全局应用程序缓存设置。
outputcache:指定应用程序范围的输出缓存设置。
outputcachesettings:指定可以应用于应用程序中页的输出缓存设置。
sqlcachedependency:为 asp.net 应用程序配置 sql 缓存依赖项。-->
<caching>
<cache disablememorycollection = "false" disableexpiration = "false" privatebyteslimit = "0" percentagephysicalmemoryusedlimit = "90" privatebytespolltime = "00:02:00"/>
<!--设计需要以这种方式缓存的页时,您需要向该页添加以下指令:<%@ outputcache cacheprofile="serveronly" %>-->
<outputcachesettings>
<outputcacheprofiles>
<add name="serveronly" duration="60" varybycustom="browser" location="server" />
</outputcacheprofiles>
</outputcachesettings>
</caching>
</system.web>
</location>
<!--网络设置。authenticationmodules:指定用于对 internet 请求进行身份验证的模块。connectionmanagement:指定与 internet 宿主的连接的最大数目。defaultproxy:配置超文本传输协议 (http) 代理服务器。mailsettings:配置简单邮件传输协议 (smtp) 邮件发送选项。requestcaching:控制网络请求的缓存机制。settings:配置 system.net 的基本网络选项。-->
<system.net>
<!--配置smtp电子邮件设置-->
<mailsettings>
<smtp from="sy">
<network host="gao" password="" username="" />
</smtp>
</mailsettings>
<!--禁用所有缓存-->
<requestcaching disableallcaching="true"></requestcaching>
<!--指定代理地址,并对本地访问和 contoso.com 跳过代理。-->
<defaultproxy>
<proxy usesystemdefault="true" proxyaddress="http://192.168.1.10:3128" bypassonlocal="true"/>
<bypasslist>
<add address="" />
</bypasslist>
</defaultproxy>
</system.net>
<!--该节替换在 httphandlers 和 httpmodules 节中添加的与 ajax 相关的 http 处理程序和模块。该节使 iis 7.0 在集成模式下运行时可使用这些处理程序和模块。在iis7.0 下运行 asp.net ajax 需要 system.webserver节。对早期版本的 iis 来说则不需要此节。 -->
<system.webserver>
<validation validateintegratedmodeconfiguration="false"/>
<modules>
<add name="scriptmodule" precondition="integratedmode" type="system.web.handlers.scriptmodule, system.web.extensions, version=3.5.0.0, culture=neutral, publickeytoken=31bf3856ad364e35"/>
</modules>
<handlers>
<remove name="webservicehandlerfactory-integrated"/>
<add name="scripthandlerfactory" verb="*" path="*.asmx" precondition="integratedmode" type="system.web.script.services.scripthandlerfactory, system.web.extensions, version=3.5.0.0, culture=neutral, publickeytoken=31bf3856ad364e35"/>
<add name="scripthandlerfactoryappservices" verb="*" path="*_appservice.axd" precondition="integratedmode" type="system.web.script.services.scripthandlerfactory, system.web.extensions, version=3.5.0.0, culture=neutral, publickeytoken=31bf3856ad364e35"/>
<add name="scriptresource" precondition="integratedmode" verb="get,head" path="scriptresource.axd" type="system.web.handlers.scriptresourcehandler, system.web.extensions, version=3.5.0.0, culture=neutral, publickeytoken=31bf3856ad364e35"/>
</handlers>
</system.webserver>
<!--asp.net ajax 中配置 asp.net 服务-->
<system.web.extensions>
<!--配置 json 序列化-->
<scripting>
<webservices>
<jsonserialization maxjsonlength="5000"/>
</webservices>
</scripting>
</system.web.extensions>
<!--对wcf的相关配置-->
<system.servicemodel>
<services>
<service name="wcfstudent.wcfstudenttext" behaviorconfiguration="servicebehavior">
<!-- service endpoints -->
<endpoint address="" binding="wshttpbinding" contract="wcfstudent.istuservicecontract">
<!-- 部署时,应删除或替换下列标识元素,以反映在其下运行部署服务的标识。删除之后,wcf 将自动推导相应标识。-->
<identity>
<dns value="localhost"/>
</identity>
</endpoint>
<endpoint address="mex" binding="mexhttpbinding" contract="imetadataexchange"/>
</service>
</services>
<behaviors>
<servicebehaviors>
<behavior name="servicebehavior">
<!-- 为避免泄漏元数据信息,请在部署前将以下值设置为 false 并删除上面的元数据终结点 -->
<servicemetadata httpgetenabled="true"/>
<!-- 要接收故障异常详细信息以进行调试,请将以下值设置为 true。在部署前设置为 false 以避免泄漏异常信息-->
<servicedebug includeexceptiondetailinfaults="false"/>
</behavior>
</servicebehaviors>
</behaviors>
</system.servicemodel>
<!--url重定向-->
<rewriter>
<rewrite url="~/user/u(.+).aspx" to="~/user/index.aspx?r=$1" />
<rewrite url="~/ask/q(.+).aspx" to="~/home/ask/content.aspx?id=$1" />
<rewrite url="~/blog/b(.+).aspx" to="~/home/blog/article.aspx?r=$1" />
<rewrite url="~/news/n(.+).aspx" to="~/home/news/content.aspx?nid=$1" />
<rewrite url="~/default.aspx" to="~/home/ram/net.aspx" />
</rewriter>
</configuration>