remove, é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 une référence à une section et à un groupe de sections hérités.
<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 |
|
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)
clear, é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