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