Partager via

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

  • Article

Mise à jour : novembre 2007

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.

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

<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

Concepts

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

Modification des fichiers de configuration ASP.NET

Scénarios de configuration ASP.NET

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)

Autres ressources

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

Paramètres de configuration ASP.NET

Fichiers de configuration ASP.NET

Administration de sites Web ASP.NET

API de configuration ASP.NET