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> SettingsLocking 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 配置设置