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

Article
09/04/2008

Mise à jour : novembre 2007

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

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

configuration, élément (Schéma des paramètres généraux)
  system.web, élément (Schéma des paramètres ASP.NET)
    pages, élément (Schéma des paramètres ASP.NET)
      controls, élément de pages (Schéma des paramètres ASP.NET)
        add, élément de controls pour pages (Schéma des paramètres ASP.NET)

<add
   assembly="assembly"
   namespace="namespace"
   src="file path"
   tagName="tag name"
   tagPrefix="tag prefix"
>

Attributs et éléments

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

Attributs

Attribut	Description
assembly	Attribut String facultatif. Spécifie le nom de l'assembly qui contient l'implémentation du contrôle COM et exige également la définition de l'attribut namespace.
namespace	Attribut String facultatif. Spécifie l'espace de noms associé au préfixe de balise et exige également la définition de l'attribut assembly, si le contrôle COM n'est pas hébergé dans le répertoire du code d'application.
src	Attribut String facultatif. Spécifie le nom du fichier qui contient le contrôle utilisateur et exige également la définition de l'attribut tagName.
tagName	Attribut String facultatif. Spécifie le nom du contrôle à utiliser dans la page et exige également la définition de l'attribut src.
tagPrefix	Attribut String requis. Spécifie le préfixe de balise mappé à un fichier source ou à un espace de noms et un assembly. Cet attribut exige la présence d'une des combinaisons d'attributs suivantes : namespace pour définir un contrôle COM, si le contrôle figure dans le répertoire du code d'application. namespace et assembly pour définir un contrôle COM. tagName et src pour définir un contrôle utilisateur.
Attributs hérités	Attributs facultatifs. Attributs hérités par tous les éléments Section.

Éléments enfants

Aucun.

É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 les paramètres de configuration spécifiques à la page, tels que les directives ASP.NET globales, pour les pages et les contrôles compris dans la portée du fichier de configuration.
controls	Définit une collection de directives de Registre et les espaces de noms où les préfixes de balise résident.

Notes

L'élément add ajoute un préfixe de balise à la collection de préfixes de balise de l'élément controls utilisés pendant la précompilation.

L'élément controls définit une collection de directives de Registre et les espaces de noms où les préfixes de balise résident. Cet élément correspond à la directive @ Register sur une page ASP.NET. La directive @ Register vous permet de spécifier le préfixe de balise pour un contrôle utilisateur.

Les préfixes de balise associent un espace de noms d'ASP.NET aux assemblys et espaces de noms dont la présence est obligatoire pour le bon fonctionnement des contrôles COM et utilisateur. Les informations suivantes sont utiles lors de la configuration de l'élément controls :

Lorsqu'ils sont appliqués à un contrôle utilisateur, vous devez définir les attributs tagPrefix, tagNameet source de l'élément enfant ajouter.
Lorsqu'ils sont appliqués à un contrôle personnalisé, vous devez définir les attributs tagPrefix, namespaceet assembly de l'élément enfant ajouter. L'attribut assembly n'est pas requis si le contrôle est dans le répertoire de code d'application.

Vous pouvez utiliser la même valeur tagPrefix pour le mappage à plusieurs assemblys ou espaces de noms.

Configuration par défaut

L'élément controls par défaut suivant est configuré dans le fichier Web.config racine.

<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>

Exemple

L'exemple de code suivant montre comment spécifier des valeurs de façon déclarative pour plusieurs attributs de l'élément controls, lesquels sont également accessibles par programme en tant que membres de la classe 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>

Informations sur les éléments

Gestionnaire de section de configuration	PagesSection
Membre de configuration	Add
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 2005

Voir aussi

Partager via

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

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires