pages 的 controls 的 add 元素（ASP.NET 设置架构）

项目
08/12/2011

向预编译期间使用的标记前缀集合添加标记前缀。

此元素是 .NET Framework 2.0 版中的新元素。

<add
   assembly="assembly"
   namespace="namespace"
   src="file path"
   tagName="tag name"
   tagPrefix="tag prefix"
>

特性和元素

以下几节描述了属性、子元素和父元素。

特性

特性	说明
assembly	可选的 String 特性。指定程序集的名称，该程序集包含 COM 控件实现并且还需要设置 namespace 特性。
namespace	可选 String 特性。指定与标记前缀关联的命名空间，如果 COM 控件不在应用程序代码目录中，则还需要设置 assembly 特性。
src	可选 String 特性。指定文件的名称，该文件包含用户控件并且还需要设置 tagName 特性。
tagName	可选 String 特性。指定页中要使用的控件的名称并且还需要设置 src 特性。
tagPrefix	必选 String 特性。指定映射到源文件或命名空间和程序集的标记前缀。该特性需要下面的其他特性组合之一：如果 COM 控件位于应用程序代码目录中，请使用 namespace 来定义 COM 控件。 namespace 和 assembly 用于定义 COM 控件。 tagName 和 src 用于定义用户控件。
继承的特性	可选特性。由所有节元素继承的特性。

子元素

无。

父元素

元素	说明
configuration	指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。
system.web	指定配置文件中 ASP.NET 配置设置的根元素，并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。
pages	定义页特定的配置设置，例如，适用于配置文件范围内的页和控件的全局 ASP.NET 指令。
controls	定义标记前缀所在的 register 指令和命名空间的集合。

备注

add 元素向预编译期间使用的 controls 元素中的标记前缀集合添加标记前缀。

controls 元素定义标记前缀所在的 register 指令和命名空间的集合。此元素对应于 ASP.NET 页上的 @ 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>

元素信息

配置节处理程序	PagesSection
配置成员	Add
可配置的位置	Machine.config 根级别的 Web.config 应用程序级别的 Web.config 虚拟或物理目录级别的 Web.config
要求	Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0 .NET Framework 2.0 版 Microsoft Visual Studio 2005

请参见

通过

pages 的 controls 的 add 元素（ASP.NET 设置架构）

特性和元素

特性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

任务

参考

概念

其他资源

其他资源