location 項目 (ASP.NET 設定結構描述)

指定子組態設定所套用至的資源,並鎖定組態設定,以防止設定遭到子組態檔覆寫。

這個項目是 .NET Framework 2.0 版中新增的項目。

configuration 項目 (一般設定結構描述)
  location 項目 (ASP.NET 設定結構描述)

<location 
      allowOverride="True|False"
   path="path" 
/>

屬性和項目

下列小節描述這個項目的屬性、子項目和父項目。

屬性

屬性 描述

allowOverride

選擇性 (Optional) Boolean 屬性。

指定組態設定是否可以由子目錄中 Web.config 檔的組態設定覆寫。

預設值為 True

path

選擇性 String 屬性。

指定所包含之組態設定要套用至的資源。使用遺漏 path 屬性的 location,會將組態設定套用至目前的目錄及所有的子目錄。如果使用沒有 path 屬性的 location,而且 allowOverrideFalse,則子目錄中的 Web.config 檔就無法變更組態設定。

子項目

location 項目可以封入其他項目,以便將組態設定套用至特定的資源或鎖定組態設定。

父項目

項目 描述

configuration

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

備註

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>

項目資訊

組態區段處理常式

不套用。

組態成員

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:鎖定 ASP.NET 組態設定
HOW TO:使用位置設定設定特定的目錄

參考

configuration 項目 (一般設定結構描述)
ConfigurationLocation

概念

ASP.NET 組態概觀
保護 ASP.NET 組態
鎖定組態設定
設定特定的檔案和子目錄

其他資源

ASP.NET 組態設定