tagMapping, élément de pages (Schéma des paramètres ASP.NET)

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Définit une collection de types de balise qui sont remappés au moment de la compilation sur d'autres types de balise.

Cet élément est une nouveauté du .NET Framework version 2.0.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Aucun

Éléments enfants

Élément

Description

add

Élément facultatif.

Ajoute un mappage de balise à la collection des mappages de balise qui sont utilisés pendant la précompilation.

clear

Élément facultatif.

Supprime toutes les références aux mappages de balises hérités, n'autorisant que les mappages de balises ajoutés par l'élément add actuel.

remove

Élément facultatif.

Supprime une référence à un mappage de balise hérité de la collection de mappages de balise.

Éléments parents

Élément

Description

configuration

Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine des paramètres de configuration ASP.NET dans un fichier de configuration et contient des éléments de configuration qui configurent des applications Web ASP.NET et contrôlent le comportement des applications.

pages

Définit globalement les paramètres de configuration spécifiques aux pages, tels que les directives ASP.NET, pour les pages et les contrôles compris dans la portée du fichier de configuration.

Notes

L'élément tagMapping définit une collection de types de balise qui sont remappés au moment de la compilation sur d'autres types de balise. Ce remappage entraîne l'utilisation du type mappé au lieu du type de balise d'origine pour toutes les pages et les contrôles de l'application ASP.NET dans la portée du fichier de configuration.

Notes

Contrairement à d'autres attributs et collections dans la section pages, le remappage de balises n'a aucune directive de page ASP.NET correspondante.

Configuration par défaut

L'élément tagMapping par défaut n'est pas configuré explicitement dans le fichier Machine.config ou dans le fichier Web.config racine. Toutefois, il s'agit de la configuration par défaut retournée par l'application.

   <tagMapping>
      <clear />
   </tagMapping>

Exemple

L'exemple de code suivant montre comment spécifier des valeurs pour plusieurs propriétés de la classe 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>

Informations sur les éléments

Gestionnaire de section de configuration

PagesSection

Membre de configuration

TagMapping

TagMapCollection

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Web.config de niveau répertoire virtuel ou physique

Configuration requise

Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0

.NET Framework version 2.0

Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Tâches

How to: Configure Specific Directories Using Location Settings

How to: Lock ASP.NET Configuration Settings

Référence

pages, élément (Schéma des paramètres ASP.NET)

add, élément de tagMapping pour pages (Schéma des paramètres ASP.NET)

clear, élément de tagMapping pour pages (Schéma des paramètres ASP.NET)

remove, élément de tagMapping pour pages (Schéma des paramètres ASP.NET)

namespaces, élément de pages (Schéma des paramètres ASP.NET)

controls, élément de pages (Schéma des paramètres ASP.NET)

system.web, élément (Schéma des paramètres ASP.NET)

configuration, élément (Schéma des paramètres généraux)

@ Page

System.Configuration

System.Web.Configuration

TagMapping

TagMapCollection

PagesSection

Concepts

ASP.NET Configuration File Hierarchy and Inheritance

Securing ASP.NET Configuration

Autres ressources

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API