remove-Element für configSections (allgemeines Einstellungsschema)
[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]
Entfernt einen Verweis auf geerbte Abschnitte und Abschnittsgruppen.
<remove
name="section name"
/>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
name |
Erforderliches String-Attribut. Gibt den Namen des zu entfernenden Abschnitts bzw. der zu entfernenden Abschnittsgruppe an. Dies ist derselbe Name, der im name-Attribut des section-Elements bzw. des sectionGroup-Elements enthalten ist, von dem der Verweis hinzugefügt wurde. |
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird. |
configSections |
Legt Konfigurationsabschnitts- und Namespacedeklarationen fest. |
sectionGroup |
Definiert eine Zuordnung zwischen einem Konfigurationsabschnittshandler und einem Konfigurationsabschnitt. |
Hinweise
Das remove-Element entfernt einen Verweis auf geerbte Abschnitte oder Abschnittsgruppen. Sie können der Auflistung in der aktuellen Konfigurationsdatei neue Abschnitte und Abschnittsgruppen hinzufügen, indem Sie das section-Element und das sectionGroup-Element verwenden.
Wenn in einer Konfigurationsdatei versucht wird, einen Konfigurationsabschnitt zu verwenden, nachdem der Handlerverweis entfernt wurde, zeigt ASP.NET den Serverfehler "Unbekannter Konfigurationsabschnitt element_name" an.
Beispiel
Das folgende Codebeispiel zeigt die Verwendung des remove-Elements in einer Anwendungskonfigurationsdatei, um einen vorher in der Datei Machine.config definierten Abschnitt zu entfernen.
In der folgenden Datei Machine.config wird ein Abschnitt mit der Bezeichnung sampleSection deklariert.
<configuration>
<configSections>
<section name="sampleSection"
type="System.Configuration.SingleTagSectionHandler" />
</configSections>
<sampleSection setting1="Value1" setting2="value two"
setting3="third value" />
</configuration>
Im folgenden Beispiel für eine Anwendungskonfigurationsdatei wird der sampleSection-Abschnitt entfernt. Nach dem Entfernen des Abschnitts kann die Anwendung die in sampleSection enthaltenen Einstellungen nicht mehr abrufen. Wenn in einer Konfigurationsdatei versucht wird, einen Konfigurationsabschnitt zu verwenden, nachdem der Handlerverweis entfernt wurde, zeigt ASP.NET den Serverfehler "Unbekannter Konfigurationsabschnitt element_name" an.
<configuration>
<configSections>
<clear/>
<section name="anotherSection"
type="System.Configuration.NameValueSectionHandler" />
</configSections>
</configuration>
Elementinformationen
Konfigurationsabschnittshandler |
Nicht vorhanden. |
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physischer Verzeichnisse |
Anforderungen |
Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 1.0, 1.1 oder 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005 |
Siehe auch
Referenz
configSections-Element (allgemeines Einstellungsschema)
sectionGroup-Element für configSections (allgemeines Einstellungsschema)
section-Element für configSections (allgemeines Einstellungsschema)
clear-Element für configSections (allgemeines Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
Konzepte
ASP.NET Configuration File Hierarchy
Format of ASP.NET Configuration Files
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen