
<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 值映射到多个程序集或命名空间。

默认配置

?	复制代码
<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>

?

复制代码

   <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

任务

如何：使用位置设置配置特定目录
如何：锁定 ASP.NET 配置设置

参考

pages 的 controls 元素（ASP.NET 设置架构）
pages 元素（ASP.NET 设置架构）
system.web 元素（ASP.NET 设置架构）
configuration 元素（常规设置架构）
@ Page
@ Register
System.Configuration
System.Web.Configuration
Controls
TagPrefixCollection
Add

概念

ASP.NET 配置文件层次结构和继承
保证 ASP.NET 配置的安全

其他资源

常规配置设置 (ASP.NET)
ASP.NET 配置设置
配置 ASP.NET 应用程序
ASP.NET 配置 API

属性和元素

属性

子元素

父元素

备注

默认配置

示例

元素信息

请参见

任务

参考

概念

其他资源