頁面控制項的 add 項目 (ASP.NET 設定結構描述)
將標記前置詞加入先行編譯期間使用的標記前置詞集合。
這個項目是 .NET Framework 2.0 版中新增的項目。
<add
assembly="assembly"
namespace="namespace"
src="file path"
tagName="tag name"
tagPrefix="tag prefix"
>
屬性和項目
下列各節將說明屬性、子項目和父項目。
屬性
屬性 |
描述 |
|---|---|
assembly |
選擇性 String 屬性。 指定組件的名稱，其中包含 COM 控制項實作，並且要求設定 namespace 屬性。 |
namespace |
選擇性 String 屬性。 指定與標記前置詞關聯的命名空間 (Namespace)，並在 COM 控制項不位於應用程式程式碼目錄時，要求設定 assembly 屬性。 |
src |
選擇性 String 屬性。 指定包含使用者控制項的檔案名稱，並且要求設定 tagName 屬性。 |
tagName |
選擇性 String 屬性。 指定要在網頁中使用之控制項的名稱，並且要求設定 src 屬性。 |
tagPrefix |
必要 String 屬性。 指定對應至原始程式檔 (Source File) 或命名空間和組件的標記前置詞。 這個屬性需要其他屬性的下列其中一種組合：
|
繼承的屬性 |
選擇性屬性。 所有區段項目繼承的屬性。 |
子項目
無。
父項目
項目 |
描述 |
|---|---|
configuration |
指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。 |
system.web |
指定組態檔中 ASP.NET 組態設定的根項目 (Root Element)，並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。 |
pages |
針對組態檔範圍內的網頁和控制項，定義網頁特定的組態設定 (例如，全域 ASP.NET 指示詞)。 |
controls |
定義標記前置詞所在的 Register 指示詞和命名空間的集合。 |
備註
add 項目會將標記前置詞加入先行編譯期間使用之 controls 項目中的標記前置詞集合。
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"
src="controls/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 2005 |
請參閱
工作
參考
頁面的 controls 項目 (ASP.NET 設定結構描述)
system.web 項目 (ASP.NET 設定結構描述)