zoukankan      html  css  js  c++  java
  • Asp.net中web.config配置文件详解(一)

    本文摘自Asp.net中web.config配置文件详解

    web.config是一个XML文件,用来储存Asp.NET Web应用程序的配置信息,包括数据库连接字符、身份安全验证等,可以出现在Asp.Net Web应用程序服务器上的任何目录中,每个Web.config将配置设置应用到它所在的目录及虚拟子目录下,子目录中的设置可以随意重写或修改在父目录中指定的设置。该文件不需要重启服务就可以生效。

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

    当我们要读取某个节点或是节点组信息时,是按照下列方式搜索的:

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

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

    (3)如果网站根目录下不存在web.config文件或者web.config文件中不存在该结点名,则在%windir%/Microsoft.NET/Framework/v2.0.50727/CONFIG/web.config文件中查找。

    (4)如果在%windir%/Microsoft.NET/Framework/v2.0.50727/CONFIG/web.config文件中不存在相应结点,则在在%windir%/Microsoft.NET/Framework/v2.0.50727/CONFIG/machine.config文件中查找。

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

    所以如果我们对某个网站或某个文件平人有特定要求的配置,可以在相应的文件夹下创建一个web.config文件,覆盖掉上级文件夹中的web.config文件中的同名配置即可。这些配置信息的寻找只查找一次,以后便缓存起来供以后调用。在Asp.net应用程序运行过程中,如果web.config文件发生更改就会导致相应的应用程序重新启动,这时存储在服务器内存中的用户会话信息就会丢失(如存储在内存中的Session)。


    网上搜集web.config文件基本用法,如下:

    <?xml version="1.0"?>
    < !--注意: 除了手动编辑此文件以外,您还可以使用 Web 管理工具来配置应用程序的设置。可以使用 Visual Studio 中的“网站”->“Asp.Net 配置”选项。
    设置和注释的完整列表在 machine.config.comments 中,该文件通常位于 系统盘:/Windows/Microsoft.Net/Framework/v2.x/Config 中。-->
     <!--Webconfig文件是一个xml文件,configuration是xml文件的根节点,由于xml文件的根节点只能有一个,所以Webconfig的所有配置都是在这个节点内进行的。-->
    < 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="1" value="1" />

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

     </appSettings>
     <!--连接字符串设置-->
     <connectionStrings>
        <add name="ConnString" connectionString="Data Source=数据库所在IP地址;Initial Catalog=数据库名称;User ID=用户名;password=密码"></add>
        <add name="111" connectionString="11111" />
     </connectionStrings>
     <!--指定应用子配置设置的资源,并锁定配置设置,以防止它们被子配置文件重写。page指定应用包含的配置设置的资源.allowOverride是否允许配置文件的重写,提高配置文件的安全性-->
     <location path="Default.aspx" allowOverride="false">

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

        <!-Pages标识特定于页的配置设置(如是否启用会话状态、视图状态,是否检测用户的输入等)。<Pages>可以在计算机、站点、应用程序和子目录级别声明。这里的几个属性的意思是默认主页为Index,主题是Default,不检测用户在浏览器输入的内容中是否存在潜在的危险数据(注:该项默认是检测,如果你使用了不检测,一要对用户的输入进行编码或验证),在从客户端回发页时将检查加密的视图状态,以验证视图状态是否已在客户端被篡改。(注:该项默认是不验证)禁用ViewState-->
        <pages masterPageFile="Index" theme="Default" buffer="true" enableViewStateMac="true" validateRequest="false" enableViewState="false">
          <!--controls 元素定义标记前缀所在的 register 指令和命名空间的集合-->
          <controls></controls>
          <!--将在程序集预编译期间使用的导入指令的集合-->
          <namespaces></namespaces>
        </pages>
        <!--customErrors是默认错误页设置,但不适用于XML Web services中发生的错误。其中mode表示对不在本地web服务器上运行的用户显示自定义友好的信息,具有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>
        <!-- compilation是配置Asp.net使用的所有编译设置。默认为debug属性为"true",设置 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、Forms、PassPort和None。其中:

          Windows:基于windows的身份验证。使用windows身份验证与IIS身份验证一起使用(IIS验证模式包括basic、digest或Integrated Windows Authentication),IIS验证完成后,Asp.net就使用己验证的身份授予访问权限,这是默认设置。

          Forms: 基于窗体的身份验证,使用HTTP客户端重定向功能。使用Forms验证,可以根据用户在基于Web的窗体上输入的凭证,为他们提供访问站点或资源的权限。终端用户尝试访问Web站点时,使用匿名身份进入站点,这是默认的身份验证模式。如果他是未通过验证上的请求即匿名的,就会被Asp.net重定向功能重定向到特定的登录页面上(如果下文的的loginUrl)。终端用户输入相应的登录信息,通过了身份验证过程后,就给他提供一个HTTP cookie,以便在后续的请求中使用。这是日前大多数web应用程序使用的方式,推荐使用此方式。

          Passport: 采用Passport cookie验证模式,是MS提供的一种集中式身份验证服务,它为成员站点提供了一个登录和核心配置服务。不推荐使用本模式。

          None: 不采用任何验证方式。该元素只能在计算机、站点或应用程序级别声明。且<authentication>元素必须与<authorization>配合使用。-->

        <authentication mode="Forms">
          <!--通过forms段,可以修改Forms验证系统的行为。其中Name: 指定终端用户完成身份验证后发送给他们的的Http cookie的名称。默认情况下,这个cookie的名称是.ASPXAUTH。LoginUrl:如果如果没找到有效的验证cookie、未通过验证或超时后重定向的页面URL,一般为登录页面,让用户重新登录,默认设置为login.aspx。Protection:指定 cookie数据的保护方式,该cookie在终端用户通过身份验证后存储在他的机器上。可设置为:All表示加密数据,并进行有效性验证两种方式,应该总使用这种方式。None表示不保护Cookie,Encryption表示对Cookie内容进行加密,validation表示对Cookie内容进行有效性验证,TimeOut: 指定Cookie的失效时间,超时后要重新登录。其中<forms>元素必须嵌套在<authentication>元素中。-->
          <forms name=".FormsAuthCookie" loginUrl="Login.aspx" protection="All" timeout="30"/>
        </authentication>
        <!--控制对 URL 资源的客户端访问(如允许匿名用户访问)。此元素可以在任何级别(计算机、站点、应用程序、子目录或页)上声明。必需与<authentication> 节配合使用。此处的意思是对匿名用户不进行身份验证。拒绝用户admin-->
        <authorization>
          <allow users="*"/>
          <deny users="admin"/>
          <allow users="aa" roles="aa" />
        </authorization>

        <!--如果禁止所有匿名用户访问,可以使用如下方式表示-->

        <authorization>

    <deny users="?">

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

        <!--

         <sessionState>为当前应用程序配置会话状态设置。mode 分为off,Inproc,StateServer,SqlServer几种状态。 

         mode = "InProc" 在本地存储会话位置,也可以选择在远程服务器或SAL服务器中或不启用会话状态,特点:具有最佳的性能,速度最快,但不能跨多台服务器存储共享。

         mode = "StateServer" 存储在状态服务器中。特点:当需要跨服务器维护用户会话信息时,使用此方法。但是信息存储在状态服务器上,一旦状态服务器出现故障,信息将丢失。 

         mode="SqlServer" 存储在sql server中,特点:工作负载会变大,但信息不会丢失。stateConnectionString:指定Asp.net应用程序存储远程会话状态的服务器名,默认为本机。

         sqlConnectionString:当用会话状态数据库时,在这里设置连接字符串。

         Cookieless:设置为flase时,表示使用cookie会话状态来标识客户,设置为true时表示用户浏览器不支持cookie时启用会话状态。

         timeout:表示会话超时时间(即会话可以处于空闲状态的分钟数)。

        关于此SessionState配置更详细的介绍请见:Session存储和配置

     -->

        <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="4096" 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="weipeng">
        <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="[a-z]+".contoso".com" />
         </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>

  • 相关阅读:
    windows如何安装python zmq
    vue.js 微信浏览器不支持lambda表达式
    Entity Framework贪婪加载筛选问题
    用swift开发自己的MacOS锁屏软件(3)
    用swift开发自己的MacOS锁屏软件(二)
    用swift开发自己的MacOS锁屏软件(一)
    The expression being assigned to optional parameter `v2' must be a constant or default value
    Laravel 使用firstOrCreate 报错MassAssignmentException
    一次PHP面试经历
    JUC学习!
  • 原文地址:https://www.cnblogs.com/Pinapple/p/6829661.html
Copyright © 2011-2022 走看看