指定应用子配置设置的资源,并锁定配置设置,以防止它们被子配置文件重写。
此元素是 .NET Framework 2.0 版中的新元素。
configuration 元素(常规设置架构)??location 元素(ASP.NET 设置架构)
<location allowOverride="True|False" path="path" /> |
属性和元素
下面几部分描述了此元素的属性、子元素和父元素。
属性
属性 | 说明 |
---|---|
allowOverride |
可选的 指定配置设置是否可以被子目录中的 Web.config 文件的配置设置重写。 默认值为 True. |
path |
可选的 指定应用包含的配置设置的资源。使用缺少 path 属性的 location 将配置设置应用于当前目录及其所有子目录。如果使用不带 path 属性的 location,并且 allowOverride 为 False,则配置设置不能被子目录中的 Web.config 文件更改。 |
子元素
location 元素可以放置在其他元素的外侧,以便将配置设置应用于特定资源或者锁定配置设置。
父元素
元素 | 说明 |
---|---|
configuration |
指定公共语言运行库和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。 |
备注
location 元素指定应用子配置设置的资源,还可用于锁定配置设置,以防止这些设置被子配置文件重写。
location 元素可以放置在其他元素的外侧,以便将配置设置应用于特定资源或者锁定这些设置。有关更多信息,请参见
示例
下面的代码示例演示如何允许匿名用户获得 Logon.aspx 页的访问权。
? | ![]() |
---|---|
<configuration> <location path="Logon.aspx"> <system.web> <authorization> <allow users="?"/> </authorization> </system.web> </location> </configuration> |
下面的代码示例演示如何仅将指定页的上载文件大小限制设置为 128 KB。
? | ![]() |
---|---|
<configuration> <location path="UploadPage.aspx"> <httpRuntime maxRequestLength="128"/> </location> </configuration> |
下面的代码示例演示如何防止配置设置被子目录中的 Web.config 文件更改。
? | ![]() |
---|---|
<configuration> <location allowOverride="false"/> </configuration> |
元素信息
配置节处理程序 |
不适用。 |
配置成员 |
|
可配置的位置 |
Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config |
要求 |
Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2003 或 Visual Studio 2005 |
请参见
任务
参考
configuration 元素(常规设置架构)概念
其他资源
ASP.NET 配置设置