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

[本文档仅供预览,在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

定义一个标记类型的集合,这些标记类型在编译时重新映射为其他标记类型。

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

<tagMapping> 
   <add /> 
   <remove /> 
   <clear/>
</tagMapping>

特性和元素

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

特性

无。

子元素

元素

说明

add

可选元素。

向预编译期间使用的标记映射集合中添加标记映射。

clear

可选元素。

移除所有对已继承标记映射的引用,只允许由当前 add 元素添加的标记映射。

remove

可选元素。

从标记映射集合中移除对继承的标记映射的引用。

父元素

元素

说明

configuration

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

system.web

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

pages

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

备注

tagMapping 元素定义一个标记类型的集合,这些标记类型在编译时重新映射为其他标记类型。 此重新映射会导致在配置文件范围内使用映射的类型替代 ASP.NET 应用程序中所有页和控件的原始标记类型。

备注

与 pages 节中的其他特性和集合不同,标记重新映射没有匹配的 ASP.NET 页指令。

默认配置

下面的默认 tagMapping 元素不是在 Machine.config 文件或根 Web.config 文件中显式配置的。 而是由应用程序返回的默认配置。

   <tagMapping>
      <clear />
   </tagMapping>

示例

下面的代码示例演示如何为 TagMapInfo 类的几个属性指定值。

   <pages>
      <tagMapping>
         <add
            tagType=
               "System.Web.UI.WebControls.WebParts.WebPartManager"
            mappedTagType=
               "Microsoft.Sharepoint.WebPartPartManager, 
                MSPS.Web.dll, Version='2.0.0.0'" 
         />
      </tagMapping>
   </pages>

元素信息

配置节处理程序

PagesSection

配置成员

TagMapping

TagMapCollection

可配置的位置

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 Directories Using Location Settings

How to: Lock ASP.NET Configuration Settings

参考

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

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

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

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

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

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

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

configuration 元素(常规设置架构)

@ Page

System.Configuration

System.Web.Configuration

TagMapping

TagMapCollection

PagesSection

概念

ASP.NET Configuration File Hierarchy and Inheritance

Securing ASP.NET Configuration

其他资源

常规配置设置 (ASP.NET)

ASP.NET 配置设置

Configuring ASP.NET Applications

ASP.NET Configuration API