Partager via

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

  • Article

Mise à jour : novembre 2007

Définit une collection de directives de Registre et les espaces de noms où les préfixes de balise résident.

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)

<controls> 
   <add /> 
</controls>

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 préfixe de balise à la collection des préfixes de balise qui sont utilisés pendant la précompilation.

É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 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 permet de spécifier le préfixe de balise d'un contrôle utilisateur.

Les préfixes de balise associent un espace de noms ASP.NET aux assemblys et espaces de noms dont la présence est obligatoire pour que les contrôles COM et utilisateur fonctionnent correctement. 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" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

Informations sur les éléments

Gestionnaire de section de configuration

PagesSection

Membre de configuration

Controls

TagPrefixCollection

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

Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Hiérarchie du fichier de configuration ASP.NET et héritage

Sécurisation de la configuration ASP.NET

Référence

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

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

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

namespaces, é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

@ Register

System.Configuration

System.Web.Configuration

Controls

TagPrefixCollection

PagesSection

Autres ressources

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

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

API de configuration ASP.NET