Partager via

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

  • Article

Mise à jour : novembre 2007

Supprime une référence à une section et à un groupe de sections hérités.

configuration, élément (Schéma des paramètres généraux)
  configSections, élément (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)
        configSections, élément (Schéma des paramètres généraux)
          sectionGroup, é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)

<remove 
   name="section name" 
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut

Description

name

Attribut String requis.

Spécifie le nom de la section ou du groupe de sections à supprimer. Cet attribut est identique à l'attribut name dans l'élément section ou sectionGroup qui a ajouté la référence.

É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 remove supprime une référence à une section ou un groupe de sections hérité. Les sections et groupes de sections nouveaux peuvent être ajoutés à la collection dans le fichier de configuration actuel en utilisant les éléments section et sectionGroup.

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 nom_élément ».

Exemple

L'exemple de code suivant montre comment utiliser l'élément remove dans un fichier de configuration de l'application pour supprimer une section précédemment définie dans le fichier Machine.config.

Le code du fichier Machine.config suivant déclare une section nommée sampleSection.

<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

L'exemple de fichier de configuration de l'application suivant supprime la section sampleSection. Au terme de la suppression, l'application ne peut pas récupérer les paramètres présents dans sampleSection. 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 nom_élément ».

<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

Remove(String)

Remove(String)

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)

clear, é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