共用方式為


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