web.config – 放牛娃Blog | 个人技术小站

本文最后更新于 738 天前，其中的信息可能已经有所发展或是发生改变。

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的所有配置都是在这个节点内进行的。–>

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

</sectionGroup>

</configSections>

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

</appSettings>

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

</connectionStrings>

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

<system.web>

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

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

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

</pages>

<!–customErrors是默认错误页设置,但不适用于XML Web services中发生的错误。其中mode表示对不在本地web服务器上运行的用户显示自定义友好的信息，具有On,Off,RemoteOnly 3种状态。On表示始终显示自定义的信息; Off表示始终显示详细的asp.net错误信息; RemoteOnly表示只对不在本地Web服务器上运行的用户显示自定义信息.defaultRedirect:用于出现错误时重定向的URL地址–>

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

</customErrors>

<!– compilation是配置Asp.net使用的所有编译设置。默认为debug属性为”true”，设置 compilation debug=”true” 将调试符号插入已编译的页面中。但由于这会影响性能，因此只在开发过程中将此值设置为 true。设置默认的开发语言C#。batch是否支持批处理–>

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

</assemblies>

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

<!—->

</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>配合使用。–>

<!–通过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>元素中。–>

</authentication>

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

</authorization>

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

</authorization>

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

<!–

<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存储和配置

–>

<!–为 ASP.NET 应用程序配置页的视图状态设置。设置要存储在页历史记录中的项数。–>

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

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

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

</httpModules>

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

add:指定映射到处理程序的谓词/路径。clear:移除当前已配置或已继承的所有处理程序映射。remove:移除映射到处理程序的谓词/路径。remove 指令必须与前一个 add 指令的谓词/路径组合完全匹配。该指令不支持通配符。–>

</httpHandlers>

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

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

<add/>

</protocols>

</webServices>

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

<!–设计需要以这种方式缓存的页时，您需要向该页添加以下指令：<%@ OutputCache CacheProfile=”ServerOnly” %>–>

</outputCacheProfiles>

</outputCacheSettings>

</caching>

</system.web>

</location>

<!–网络设置，authenticationModules：指定用于对 Internet 请求进行身份验证的模块。connectionManagement：指定与 Internet 宿主的连接的最大数目。defaultProxy：配置超文本传输协议 (HTTP) ＊＊＊＊＊。

mailSettings：配置简单邮件传输协议 (SMTP) 邮件发送选项。requestCaching：控制网络请求的缓存机制。settings：配置 System.Net 的基本网络选项。–>

<system.net>

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

</smtp>

</mailSettings>

<!–禁用所有缓存–>

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

</bypasslist>

</defaultProxy>

</system.net>

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

<system.webServer>

</modules>

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

</handlers>

</system.webServer>

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

<system.web.extensions>

<!–配置 JSON 序列化–>

</webServices>

</scripting>

</system.web.extensions>

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

<system.serviceModel>

<!– Service Endpoints –>

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

</identity>

</endpoint>

</service>

</services>

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

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

</behavior>

</serviceBehaviors>

</behaviors>

</system.serviceModel>

<!–URL重定向–>

</rewriter>

</configuration>

2024 年 4 月
一	二	三	四	五	六	日
						1
2	3	4	5	6	7	8
9	10	11	12	13	14	15
16	17	18	19	20	21	22
23	24	25	26	27	28	29
30	31

发送评论 编辑评论

推荐文章

发送评论编辑评论