Freigeben über

remove-Element für configSections (allgemeines Einstellungsschema)

  • Artikel

Aktualisiert: November 2007

Entfernt einen Verweis auf geerbte Abschnitte und Abschnittsgruppen.

configuration-Element (allgemeines Einstellungsschema)
  configSections-Element (allgemeines Einstellungsschema)
    remove-Element für configSections (allgemeines Einstellungsschema)
      configuration-Element (allgemeines Einstellungsschema)
        configSections-Element (allgemeines Einstellungsschema)
          sectionGroup-Element für configSections (allgemeines Einstellungsschema)
            remove-Element für configSections (allgemeines Einstellungsschema)

<remove 
   name="section name" 
/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie ü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

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 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

Konzepte

ASP.NET-Konfigurationsdateihierarchie und Vererbung

Bearbeiten von ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurationsszenarios

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)

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

ASP.NET-Konfigurationsdateien

Verwalten von ASP.NET-Websites

ASP.NET-Konfigurations-API