Partager via

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

  • Article

[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 directives de Registre et les espaces de noms où les préfixes de balise résident.

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

<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

How to: Configure Specific Folders 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 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

Concepts

ASP.NET Configuration File Hierarchy

Securing 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