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	指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。

備註

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 Information Services (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 組態設定