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 項目可以封入其他項目，以便將組態設定套用至特定的資源或鎖定設定。 如需詳細資訊，請參閱設定特定的檔案和子目錄和鎖定組態設定。
範例
下列程式碼範例會示範如何允許匿名使用者存取 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>
項目資訊
組態區段處理常式 |
不套用。 |
組態成員 |
|
可設定的位置 |
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 |