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 元素可以放置在其他元素的外侧,以便将配置设置应用于特定资源或者锁定这些设置。 有关更多信息,请参见 配置特定文件和子目录锁定配置设置

示例

下面的代码示例演示如何允许匿名用户获得 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

请参见

任务

如何:锁定 ASP.NET 配置设置

如何:使用位置设置配置特定目录

参考

configuration 元素(常规设置架构)

ConfigurationLocation

概念

ASP.NET 配置概述

保证 ASP.NET 配置的安全

锁定配置设置

配置特定文件和子目录

其他资源

ASP.NET 配置设置