`

Web.config配置文件详解

阅读更多

[网络收集]Web.config配置文件详解

摘录自:http://hi.baidu.com/fanfanwuji/blog/item/a7fd8928d49a7ef098250a06.html

花了点时间整理了一下ASP.NET Web.config配置文件的基本使用方法。很适合新手参看,由于Web.config在使用很灵活,可以自定义一些节点。所以这里只介绍一些比较常用的节点。

<?xml version="1.0"?>

<!--注意: 除了手动编辑此文件以外,您还可以使用 Web 管理工具来配置应用程序的设置。可以使用 Visual Studio 中的“网站”->“Asp.Net 配置”选项。</p> <p>设置和注释的完整列表在 machine.config.comments 中,该文件通常位于 "Windows"Microsoft.Net"Framework"v2.x"Config 中。-->

<!--Webconfig文件是一个xml文件,configuration是xml文件的根节点,由于xml文件的根节点只能有一个,所以Webconfig的所有配置都是在这个节点内进行的。-->

<configuration></configuration>

<!--指定配置节和命名空间声明。clear:移除对继承的节和节组的所有引用,只允许由当前 section 和 sectionGroup 元素添加的节和节组。remove:移除对继承的节和节组的引用。</p> <p>section:定义配置节处理程序与配置元素之间的关联。sectionGroup:定义配置节处理程序与配置节之间的关联。-->

<configsections></configsections>

<sectiongroup name="system.web.extensions" type="System.Web.Configuration.SystemWebExtensionsSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"></sectiongroup>

<sectiongroup name="scripting" type="System.Web.Configuration.ScriptingSectionGroup, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"></sectiongroup>

<section name="scriptResourceHandler" type="System.Web.Configuration.ScriptingScriptResourceHandlerSection, System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" requirepermission="false" allowdefinition="MachineToApplication"></section>

<section name="rewriter" type="Intelligencia.UrlRewriter.Configuration.RewriterConfigurationSectionHandler, Intelligencia.UrlRewriter"></section><!--用于url改写-->

<!--appSettings是应用程序设置,可以定义应用程序的全局常量设置等信息-->

<appsettings></appsettings>

<add key="1" value="1"></add>

<add key="gao" value="weipeng"></add>

<add key="scon" value="server=a;database=northwind;uid=sa;pwd=123"></add>

<!--连接字符串设置-->

<connectionstrings></connectionstrings>

<add name="ConnString" connectionstring="Data Source=GAO;Initial Catalog=HBWXDate;User ID=sa;password=sa"></add>

<add name="111" connectionstring="11111"></add>

<!--指定应用子配置设置的资源,并锁定配置设置,以防止它们被子配置文件重写。page指定应用包含的配置设置的资源.allowOverride是否允许配置文件的重写,提高配置文件的安全性-->

<location path="Default.aspx" allowoverride="false"></location>

<!--控制asp.net运行时的行为-->

<system.web></system.web>

<!--identity控制web应用程序的身份验证标识.-->

<identity impersonate="false"></identity>

<!--标识特定于页的配置设置(如是否启用会话状态、视图状态,是否检测用户的输入等)。<pages>可以在计算机、站点、应用程序和子目录级别声明.</p> <p> 这里的几个属性的意思是默认主页为Index,主题是Default,不检测用户在浏览器输入的内容中是否存在潜在的危险数据(注:该项默认是检测,如果你使用了不检测,一要对用户的输入进行编码或验证),在从客户端回发页时将检查加密的视图状态,以验证视图状态是否已在客户端被篡改。(注:该项默认是不验证)禁用ViewState-->

<pages masterpagefile="Index" theme="Default" buffer="true" enableviewstatemac="true" validaterequest="false" enableviewstate="false"></pages>

<!--controls 元素定义标记前缀所在的 register 指令和命名空间的集合-->

<controls></controls>

<!--将在程序集预编译期间使用的导入指令的集合-->

<namespaces></namespaces>

<!--默认错误页设置,mode:具有On,Off,RemoteOnly 3种状态 <br />customErrors mode="On" 或 "RemoteOnly" 以启用自定义错误信息,或设置为 "Off" 以禁用自定义错误信息。 <br />为每个要处理的错误添加 <error> 标记。 <br />"On" 始终显示自定义(友好的)信息。 <br />"Off" 始终显示详细的 ASP.NET 错误信息。 <br />"RemoteOnly" 只对不在本地 Web 服务器上运行的 <br />用户显示自定义(友好的)信息。出于安全目的,建议使用此设置,以便 <br />不向远程客户端显示应用程序的详细信息。 <br />defaultRedirect:用于出现错误时重定向的URL地址 <br />-->

<customerrors defaultredirect="Err.html" mode="RemoteOnly"></customerrors>

<!--特殊代码编号的错误从定向文件-->

<error statuscode="403" redirect="NoAccess.htm"></error>

<error statuscode="404" redirect="FileNotFound.htm"></error>

<!--配置调试和跟踪:下面配置的意思是启动调试(默认),捕获跟踪信息,要缓存的跟踪请求个数(15),跟踪结果的排列顺序-->

<trace enabled="true" localonly="false" pageoutput="true" requestlimit="15" tracemode="SortByCategory"></trace>

<!-- 设置 compilation debug="true" 以启用 ASPX 调试。否则,将此值设置为 <br />false 将提高此应用程序的运行时性能。 <br />设置 compilation debug="true" 以将调试符号(.pdb 信息) <br />插入到编译页中。因为这将创建执行起来 <br />较慢的大文件,所以应该只在调试时将此值设置为 true,而在所有其他时候都设置为 <br />false。有关更多信息,请参考有关调试 ASP.NET 文件的文档。 <br />设置默认的开发语言C#。batch是否支持批处理-->

<compilation debug="true" defaultlanguage="c#" batch="false"></compilation>

<assemblies></assemblies>

<!--加的程序集引用,每添加一个程序集,就表示你的应用程序已经依赖了一个程序集,你就可以在你的应用程序中使用了-->

<add assembly="System.Web.Extensions, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"></add>

<add assembly="System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"></add>

<add assembly="System.Web.Extensions.Design, Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"></add>

<add assembly="System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"></add>

<add assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"></add>

<add assembly="System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"></add>

<add assembly="System.Xml, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"></add>

<add assembly="System.Drawing, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"></add>

<add assembly="System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089"></add>

<add assembly="System.Web.Services, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"></add>

<add assembly="System.Configuration, Version=2.0.0.0, Culture=neutral, PublicKeyToken=B03F5F7F11D50A3A"></add>

<!--定义用于编译自定义资源文件的生成提供程序的集合。-->

<buildproviders></buildproviders>

<!---->

<add extension=".aspx" type="System.Web.Compilation.PageBuildProvider"></add>

<add extension=".ascx" type="System.Web.Compilation.UserControlBuildProvider"></add>

<add extension=".master" type="System.Web.Compilation.MasterPageBuildProvider"></add>

<add extension=".asmx" type="System.Web.Compilation.WebServiceBuildProvider"></add>

<add extension=".ashx" type="System.Web.Compilation.WebHandlerBuildProvider"></add>

<add extension=".soap" type="System.Web.Compilation.WebServiceBuildProvider"></add>

<add extension=".resx" type="System.Web.Compilation.ResXBuildProvider"></add>

<add extension=".resources" type="System.Web.Compilation.ResourcesBuildProvider"></add>

<add extension=".wsdl" type="System.Web.Compilation.WsdlBuildProvider"></add>

<add extension=".xsd" type="System.Web.Compilation.XsdBuildProvider"></add>

<add extension=".rdlc" type="Microsoft.Reporting.RdlBuildProvider, Microsoft.ReportViewer.Common, Version=8.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"></add>

<!--通过 <authentication> 节可以配置 ASP.NET 使用的 安全身份验证模式,以标识传入的用户。Windows: IIS 根据应用程序的设置执行身份验证 <br />(基本、简要或集成 Windows),在 IIS 中必须禁用匿名访问。,Forms: 使用基于窗体的验证方式,为用户提供一个输入凭据的自定义窗体(Web 页),然后 <br />在您的应用程序中验证他们的身份,用户凭据标记存储在 Cookie 中。Passport: 采用Passport 通过 Microsoft 的集中身份验证服务执行的, <br />它为成员站点提供单独登录和核心配置文件服务。,None: 不采用任何验证方式-->

<authentication mode="Forms"></authentication>

<!--Name: 指定完成身份验证的Http cookie的名称.LoginUrl: 如果未通过验证或超时后重定向的页面URL,一般为登录页面,让用户重新登录。Protection: 指定 cookie数据的保护方式.</p> <p> 可设置为:All表示加密数据,并进行有效性验证两种方式,None表示不保护Cookie,Encryption表示对Cookie内容进行加密,validation表示对Cookie内容进行有效性验证,TimeOut: 指定Cookie的失效时间. 超时后要重新登录。-->

<forms name=".ASPXUSERDEMO" loginurl="Login.aspx" protection="All" timeout="30"></forms>

<!--控制对 URL 资源的客户端访问(如允许匿名用户访问)。此元素可以在任何级别(计算机、站点、应用程序、子目录或页)上声明。必需与<authentication> 节配合使用。此处的意思是对匿名用户不进行身份验证。拒绝用户weipeng-->

<!-- 授权 此节设置应用程序的授权策略。可以允许或拒绝不同的用户或角色访问应用程序资源。通配符: "*" 表示任何人,"?" 表示匿名(未经身份验证的)用户。-->
<authorization></authorization>
<allow users="*"></allow><!-- 允许所有用户 -->
<deny users="weipeng"></deny>

<!--<allow users="[逗号分隔的用户列表]"</strong> <br /><strong>roles="[逗号分隔的角色列表]"/></strong> <br /><strong><deny users="[逗号分隔的用户列表]"</strong> <br /><strong>roles="[逗号分隔的角色列表]"/></strong> <br /><strong>-->

<allow users="aa" roles="aa"></allow>

<!--站点全球化设置,requestEncoding: 它用来检查每一个发来请求的编码.responseEncoding: 用于检查发回的响应内容编码.fileEncoding:用于检查aspx,asax等文件解析的默认编码,默认的编码是utf-8-->

<globalization requestencoding="gb2312" responseencoding="gb2312" fileencoding="gb2312"></globalization>

<!--会话状态设置。mode: 分为off,Inproc,StateServer,SqlServer几种状态 mode = InProc 存储在进程中特点:具有最佳的性能,速度最快,但不能跨多台服务器存储共享.mode = "StateServer" 存储在状态服务器中特点:当需要跨服务器维护用户会话信息时,使用此方法。但是信息存储在状态服务器上,一旦状态服务器出现故障,信息将丢失. mode="SqlServer" 存储在sql server中特点:工作负载会变大,但信息不会丢失</p> <p> 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"></sessionpagestate>

<!--配置asp.net http运行库的设置。可以在计算机,站点,应用程序和子目录级别声明</p> <p> 允许最多的请求个数100,最长允许执行请求时间为80秒,控制用户上传文件的大小,默认是4M。useFullyQualifiedRedirectUrl客户端重定向不需要被自动转换为完全限定格式。-->

<httpruntime apprequestqueuelimit="100" executiontimeout="80" maxrequestlength="40960" usefullyqualifiedredirecturl="false"></httpruntime>

<!--httpModules在一个应用程序内配置 HTTP 模块。-->

<httpmodules></httpmodules>

<add name="OutputCache" type="System.Web.Caching.OutputCacheModule"></add>

<add name="Session" type="System.Web.SessionState.SessionStateModule"></add>

<add name="WindowsAuthentication" type="System.Web.Security.WindowsAuthenticationModule"></add>

<add name="FormsAuthentication" type="System.Web.Security.FormsAuthenticationModule"></add>

<add name="PassportAuthentication" type="System.Web.Security.PassportAuthenticationModule"></add>

<add name="RoleManager" type="System.Web.Security.RoleManagerModule"></add>

<add name="UrlAuthorization" type="System.Web.Security.UrlAuthorizationModule"></add>

<add name="FileAuthorization" type="System.Web.Security.FileAuthorizationModule"></add>

<add name="AnonymousIdentification" type="System.Web.Security.AnonymousIdentificationModule"></add>

<!--自定义的URL重写,type基本上就是dll名-->

<add name="UrlRewriter" type="Intelligencia.UrlRewriter.RewriterHttpModule, Intelligencia.UrlRewriter"></add>

<add name="Profile" type="System.Web.Profile.ProfileModule"></add>

<!--httpHandlers用于根据用户请求的URL和HTTP谓词将用户的请求交给相应的处理程序。可以在配置级别的任何层次配置此节点,也就是说可以针对某个特定目录下指定的特殊文件进行特殊处理。</p> <p> add:指定映射到处理程序的谓词/路径。clear:移除当前已配置或已继承的所有处理程序映射。remove:移除映射到处理程序的谓词/路径。remove 指令必须与前一个 add 指令的谓词/路径组合完全匹配。该指令不支持通配符。-->

<httphandlers></httphandlers>

<remove verb="*" path="*.asmx"></remove>

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

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

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

<add verb="POST,GET" path="ajaxpro/*.ashx" type="AjaxPro.AjaxHandlerFactory, AjaxPro.2"></add>

<!--为 Web 应用程序使用的 Cookie 配置属性。domain:设置 Cookie 域名。httpOnlyCookies:在 Internet Explorer 6 SP1 中启用 HttpOnlyCookies Cookie 的输出。默认值为 false。requireSSL:获取一个指示是否需要安全套接字层 (SSL) 通信的值.-->

<httpcookies httponlycookies="false" requiressl="false"></httpcookies>

<!--控制 ASP.NET Web 服务及其客户端的行为。protocols:指定传输协议,ASP.NET 可使用这些传输协议来解密 HTTP-->

<webservices></webservices>

<protocols></protocols>

<add></add>

<!--为 Web 应用程序配置缓存设置。cache:定义全局应用程序缓存设置。outputCache :指定应用程序范围的输出缓存设置。outputCacheSettings:指定可以应用于应用程序中页的输出缓存设置。sqlCacheDependency:为 ASP.NET 应用程序配置 SQL 缓存依赖项。-->

<caching></caching>

<cache disablememorycollection="false" disableexpiration="false" privatebyteslimit="0" percentagephysicalmemoryusedlimit="90" privatebytespolltime="00:02:00"></cache>

<!--设计需要以这种方式缓存的页时,您需要向该页添加以下指令:<%@ OutputCache CacheProfile="ServerOnly" %>-->

<outputcachesettings></outputcachesettings>

<outputcacheprofiles></outputcacheprofiles>

<add name="ServerOnly" duration="60" varybycustom="browser" location="Server"></add>

<!--网络设置,authenticationModules:指定用于对 Internet 请求进行身份验证的模块。connectionManagement:指定与 Internet 宿主的连接的最大数目。defaultProxy:配置超文本传输协议 (HTTP) 代理服务器。</p> <p>mailSettings:配置简单邮件传输协议 (SMTP) 邮件发送选项。requestCaching:控制网络请求的缓存机制。settings:配置 System.Net 的基本网络选项。-->

<system.net></system.net>

<!--配置SMTP电子邮件设置-->

<mailsettings></mailsettings>

<smtp from="weipeng"></smtp>

<network host="Gao" password="" username=""></network>

<!--禁用所有缓存-->

<requestcaching disableallcaching="true"></requestcaching>

<!--指定代理地址,并对本地访问和 contoso.com 跳过代理。-->

<defaultproxy></defaultproxy>

<proxy usesystemdefault="True" proxyaddress="&lt;a href=" http:>http://192.168.1.10:3128" bypassonlocal="True"/&gt;</proxy>

<bypasslist></bypasslist>

<add address="[a-z]+" .contoso></add>

<!--该节替换在 httpHandlers 和 httpModules 节中添加的与 AJAX 相关的 HTTP 处理程序和模块。该节使 IIS 7.0 在集成模式下运行时可使用这些处理程序和模块。在iis7.0 下运行 ASP.NET AJAX 需要 system.webServer</p> <p>节。对早期版本的 IIS 来说则不需要此节。 -->

<system.webserver></system.webserver>

<validation validateintegratedmodeconfiguration="false"></validation>

<modules></modules>

<add name="ScriptModule" precondition="integratedMode" type="System.Web.Handlers.ScriptModule, System.Web.Extensions, Version=3.5.0.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35"></add>

<handlers></handlers>

<remove name="WebServiceHandlerFactory-Integrated"></remove>

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

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

<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"></add>

<!--ASP.NET AJAX 中配置 ASP.NET 服务-->

<system.web.extensions></system.web.extensions>

<!--配置 JSON 序列化-->

<ing></ing>

<webservices></webservices>

<jsonserialization maxjsonlength="5000"></jsonserialization>

<!--对WCF的相关配置-->

<system.servicemodel></system.servicemodel>

<services></services>

<service name="WCFStudent.WCFStudentText" behaviorconfiguration="ServiceBehavior"></service>

<!-- Service Endpoints -->

<endpoint address="" binding="wsHttpBinding" contract="WCFStudent.IStuServiceContract"></endpoint>

<!-- 部署时,应删除或替换下列标识元素,以反映在其下运行部署服务的标识。删除之后,WCF 将自动推导相应标识。-->

<identity></identity>

<dns value="localhost"></dns>

<endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange"></endpoint>

<behaviors></behaviors>

<servicebehaviors></servicebehaviors>

<behavior name="ServiceBehavior"></behavior>

<!-- 为避免泄漏元数据信息,请在部署前将以下值设置为 false 并删除上面的元数据终结点 -->

<servicemetadata httpgetenabled="true"></servicemetadata>

<!-- 要接收故障异常详细信息以进行调试,请将以下值设置为 true。在部署前设置为 false 以避免泄漏异常信息-->

<servicedebug includeexceptiondetailinfaults="false"></servicedebug>

<!--URL重定向-->

<rewriter></rewriter>

<rewrite url="~/user/u(.+).aspx" to="~/user/index.aspx?r=$1"></rewrite>

<rewrite url="~/ask/q(.+).aspx" to="~/home/ask/content.aspx?id=$1"></rewrite>

<rewrite url="~/blog/b(.+).aspx" to="~/home/blog/article.aspx?r=$1"></rewrite>

<rewrite url="~/news/n(.+).aspx" to="~/home/news/content.aspx?nid=$1"></rewrite>

<rewrite url="~/default.aspx" to="~/home/ram/net.aspx"></rewrite>

分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics