pages 的 controls 元素(ASP.NET 设置架构)

定义标记前缀所在的 register 指令和命名空间的集合。

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

<controls> 
   <add /> 
</controls>

特性和元素

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

特性

无。

子元素

元素

说明

add

可选元素。

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

父元素

元素

说明

configuration

指定公共语言运行时和 .NET Framework 应用程序所使用的每个配置文件中均需要的根元素。

system.web

指定配置文件中 ASP.NET 配置设置的根元素,并包含用于配置 ASP.NET Web 应用程序和控制应用程序行为方式的配置元素。

pages

定义全局范围的页特定的配置设置,例如,适用于配置文件范围内的页和控件的 ASP.NET 指令。

备注

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" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

元素信息

配置节处理程序

PagesSection

配置成员

Controls

TagPrefixCollection

可配置的位置

Machine.config

根级别的 Web.config

应用程序级别的 Web.config

虚拟或物理目录级别的 Web.config

要求

Microsoft Internet 信息服务 (IIS) 版本 5.0、5.1 或 6.0

.NET Framework 2.0 版

Microsoft Visual Studio 2003 或 Visual Studio 2005

请参见

任务

如何:使用位置设置配置特定目录

如何:锁定 ASP.NET 配置设置

参考

pages 元素(ASP.NET 设置架构)

pages 的 controls 的 add 元素(ASP.NET 设置架构)

pages 的 tagMapping 元素(ASP.NET 设置架构)

pages 的 namespaces 元素(ASP.NET 设置架构)

system.web 元素(ASP.NET 设置架构)

configuration 元素(常规设置架构)

@ Page

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

PagesSection

概念

ASP.NET 配置文件层次结构和继承

保证 ASP.NET 配置的安全

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

ASP.NET 网站管理

ASP.NET 配置 API