頁面的 controls 項目 (ASP.NET 設定結構描述)
更新：2007 年 11 月
定義標記前置詞所在的 Register 指示詞和命名空間的集合。
這個項目是 .NET Framework 2.0 版中新增的項目。
configuration 項目 (一般設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)
pages 項目 (ASP.NET 設定結構描述)
頁面的 controls 項目 (ASP.NET 設定結構描述)
<controls>
<add />
</controls>
屬性和項目
下列小節描述屬性、子項目和父項目。
屬性
無。
子項目
項目 |
說明 |
|---|---|
add |
選擇性項目。 將標記前置詞加入先行編譯期間使用的標記前置詞集合。 |
父項目
項目 |
說明 |
|---|---|
configuration |
指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。 |
system.web |
指定組態檔中 ASP.NET 組態設定的根項目 (Root Element)，並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。 |
pages |
以全域方式定義網頁特定的組態設定，例如，位於組態檔範圍內之網頁和控制項的 ASP.NET 指示詞。 |
備註
controls 項目定義標記前置詞所在的命名空間和 Register 指示詞的集合。這個項目會對應至 ASP.NET Web 網頁上的 @ Register 指示詞。@ Register 指示詞可讓您指定使用者控制項的標記前置詞。
標記前置詞使 ASP.NET 中的命名空間與組件和命名空間產生關聯，沒有這些組件和命名空間，COM 和使用者控制項將無法正常運作。下列資訊有助於設定 controls 項目：
如果套用至使用者控制項，您就必須定義 add 子項目的 tagPrefix、tagName 和 source 屬性。
如果套用至自訂控制項，您就必須定義 add 子項目的 tagPrefix、namespace 和 assembly 屬性。如果控制項位於應用程式程式碼目錄中，則不需要 assembly 屬性。
您可以使用相同的 tagPrefix 值，對應多重組件或命名空間。
預設的組態
下列預設 controls 項目會在根 Web.config 檔中設定。
<pages>
<controls>
<add
tagPrefix="asp"
namespace="System.Web.UI.WebControls.WebParts"
assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
/>
</controls>
<!-- Other elements -->
</pages>
範例
下列程式碼範例將示範如何以宣告方式為 controls 項目的數個屬性指定值，這些屬性也可以程式設計的方式當做 TagPrefixInfo 類別的成員進行存取。
<pages>
<controls>
<!—- Searches all linked assemblies for the namespace -->
<add
tagPrefix="MyTags1"
namespace="MyNameSpace"/>
<!-- Uses a specified assembly -->
<add
tagPrefix="MyTags2"
namespace="MyNameSpace"
assembly="MyAssembly"/>
<!-- Uses the specified source for the user control -->
<add
tagPrefix="MyTags3"
tagName="MyCtrl"
source="MyControl.ascx"/>
</controls>
</pages>
項目資訊
組態區段處理常式 |
|
組態成員 |
|
可設定的位置 |
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 |
請參閱
工作
概念
參考
頁面控制項的 add 項目 (ASP.NET 設定結構描述)
頁面的 tagMapping 項目 (ASP.NET 設定結構描述)
頁面的 namespaces 項目 (ASP.NET 設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)