clear, élément de configSections (Schéma des paramètres généraux)
[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.]
Supprime toutes les références aux sections et aux groupes de sections hérités, n'autorisant que les sections et groupes de sections ajoutés par les éléments section et sectionGroup actuels.
<clear />
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
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. |
configSections |
Spécifie une section de configuration et des déclarations d'espace de noms. |
sectionGroup |
Définit une association entre un gestionnaire de section de configuration et une section de configuration. |
Notes
L'élément clear supprime toutes les références aux sections et aux groupes de sections hérités, n'autorisant que les sections et groupes de sections ajoutés par les éléments section et sectionGroup actuels.
Si un fichier de configuration tente d'utiliser une section de configuration après que la référence au gestionnaire a été supprimée, ASP.NET publie l'erreur de serveur « Section de configuration non reconnue element_name ».
Exemple
L'exemple de code suivant montre comment utiliser l'élément clear dans un fichier de configuration de l'application pour supprimer des sections précédemment définies dans le fichier Machine.config.
Le code suivant d'un fichier Machine.config déclare deux sections, sampleSection et anotherSampleSection, lesquelles sont lues avant le fichier de configuration de l'application.
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler" />
<section name="anotherSampleSection"
type="System.Configuration.NameValueSectionHandler" />
</configSections>
<sampleSection setting1="Value1" setting2="value two"
setting3="third value" />
</configuration>
Le code suivant d'un fichier de configuration de l'application supprime toutes les sections déclarées précédemment. L'application ne peut utiliser ou récupérer des paramètres dans aucune des sections déclarées dans le fichier Machine.config. Elle peut toutefois utiliser les paramètres de la section anotherSection, car anotherSection est placée après l'élément clear.
<configuration>
<configSections>
<clear/>
<section name="anotherSection"
type="System.Configuration.NameValueSectionHandler" />
</configSections>
</configuration>
Informations sur les éléments
Gestionnaire de section de configuration |
Non applicable. |
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 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005 |
Voir aussi
Référence
configSections, élément (Schéma des paramètres généraux)
sectionGroup, élément de configSections (Schéma des paramètres généraux)
section, élément de configSections (Schéma des paramètres généraux)
remove, élément de configSections (Schéma des paramètres généraux)
configuration, élément (Schéma des paramètres généraux)
Concepts
ASP.NET Configuration File Hierarchy
Format of ASP.NET Configuration Files
Autres ressources
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET