remove-Element für configSections (allgemeines Einstellungsschema)

Artikel
08/10/2011

Entfernt einen Verweis auf geerbte Abschnitte und Abschnittsgruppen.

<remove 
   name="section name" 
/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribute	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	Remove(String) Remove(String)
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physikalischer 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

remove-Element für configSections (allgemeines Einstellungsschema)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Beispiel

Elementinformationen

Siehe auch

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen