Partager via

clear, élément de configSections (Schéma des paramètres généraux)

  • 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.]

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

Clear()

Clear()

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

Configuration Inheritance

Autres ressources

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

Paramètres de configuration ASP.NET

ASP.NET Configuration Files

Configuring ASP.NET Applications

ASP.NET Configuration API