controls, é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 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 |
|
Membre de configuration |
|
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)
Concepts
ASP.NET Configuration File Hierarchy
Autres ressources
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET