頁面的 controls 項目 (ASP.NET 設定結構描述)

發行項
05/28/2012

定義標記前置詞所在的 Register 指示詞和命名空間的集合。

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

<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>

項目資訊

組態區段處理常式	PagesSection
組態成員	Controls TagPrefixCollection
可設定的位置	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

請參閱

共用方式為

頁面的 controls 項目 (ASP.NET 設定結構描述)

屬性和項目

屬性

子項目

父項目

備註

預設組態

範例

項目資訊

請參閱

工作

參考

概念

其他資源

其他資源