location 元素（ASP.NET 设置架构）

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

指定应用子配置设置的资源，并锁定配置设置，以防止它们被子配置文件重写。

此元素是 .NET Framework 2.0 版中的新元素。

<location 
   allowOverride="true|false"
   path="path" 
/>

特性和元素

下面几部分描述了此元素的特性、子元素和父元素。

特性

特性	说明
allowOverride	可选的 Boolean 特性。 指定配置设置是否可以被子目录中的 Web.config 文件的配置设置重写。 默认值为 true。
path	可选的 String 特性。 指定应用包含的配置设置的资源。 使用缺少 path 特性的 location 将配置设置应用于当前目录及其所有子目录。 如果使用不带 path 特性的 location，并且 allowOverride 为 false，则配置设置不能被子目录中的 Web.config 文件更改。
inheritInChildApplications	可选的 Boolean 特性。 指定在某一特定位置（如某个网站的根目录）的配置设置是否被子目录中的应用程序所继承。 默认值为 true。

子元素

location 元素可以放置在其他元素的外侧，以便将配置设置应用于特定资源或者锁定配置设置。

父元素

元素	说明
configuration	指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

备注

location 元素指定应用子配置设置的资源，还可用于锁定配置设置，以防止这些设置被子配置文件重写。

location 元素可以放置在其他元素的外侧，以便将配置设置应用于特定资源或者锁定这些设置。 有关更多信息，请参见Configuration <location> Settings和 Locking Configuration Settings。

示例

下面的代码示例演示如何允许匿名用户获得 Logon.aspx 页的访问权。

<configuration>
   <location path="Logon.aspx">
      <system.web>
         <authorization>
            <allow users="?"/>
         </authorization>
      </system.web>
   </location>
</configuration>

下面的代码示例演示如何仅将指定页的上载文件大小限制设置为 128 KB。

<configuration>
  <location path="UploadPage.aspx">
    <system.web>
      <httpRuntime maxRequestLength="128"/>
    </system.web>
  </location>
</configuration>

下面的代码示例演示如何防止配置设置被子目录中的 Web.config 文件更改。

<configuration>
   <location allowOverride="false"/>
</configuration>

元素信息

配置节处理程序	不适用。
配置成员	ConfigurationLocation
可配置的位置	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

请参见

任务

How to: Lock ASP.NET Configuration Settings

How to: Configure Specific Folders Using Location Settings

参考

configuration 元素（常规设置架构）

ConfigurationLocation

概念

ASP.NET Configuration Overview

Securing Configuration

Locking Configuration Settings

Configuration <location> Settings

其他资源

ASP.NET 配置设置