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>
元素信息
配置节处理程序 |
|
配置成员 |
|
可配置的位置 |
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 |
请参见
任务
How to: Configure Specific Folders Using Location Settings
How to: Lock ASP.NET Configuration Settings
参考
pages 的 controls 的 add 元素（ASP.NET 设置架构）
pages 的 tagMapping 元素（ASP.NET 设置架构）
pages 的 namespaces 元素（ASP.NET 设置架构）
概念
ASP.NET Configuration File Hierarchy