clear-Element für configSections (allgemeines Einstellungsschema)

  • Artikel

Entfernt alle Verweise auf geerbte Abschnitte und Abschnittsgruppen, bis auf die durch das aktuelle section-Element und das aktuelle sectionGroup-Element hinzugefügten Abschnitte und Abschnittsgruppen.

<clear />

Attribute und Elemente

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

Attribute

Keine.

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 clear-Element entfernt alle Verweise auf geerbte Abschnitte und Abschnittsgruppen, bis auf die durch das aktuelle section-Element und das aktuelle sectionGroup-Element hinzugefügten Abschnitte und Abschnittsgruppen.

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 clear-Elements in einer Anwendungskonfigurationsdatei zum Entfernen von Abschnitten, die zuvor in der Datei Machine.config definiert wurden.

Der folgende Code aus einer Datei Machine.config deklariert zwei Abschnitte, sampleSection und anotherSampleSection, die vor der Anwendungskonfigurationsdatei gelesen werden.

<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
      <section name="anotherSampleSection"
               type="System.Configuration.NameValueSectionHandler" />
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

Im folgenden Code einer Anwendungskonfigurationsdatei werden alle vorher deklarierten Abschnitte gelöscht. Die Anwendung kann die Einstellungen, die in den beiden in der Datei Machine.config deklarierten Abschnitten enthalten sind, weder verwenden noch abrufen. Die Anwendung kann jedoch die in anotherSection enthaltenen Einstellungen verwenden, da sich anotherSection hinter dem clear-Element befindet.

<configuration>

<configSections>

<clear/>

<section name="anotherSection"

type="System.Configuration.NameValueSectionHandler" />

</configSections>

</configuration>

Elementinformationen

Konfigurationsabschnittshandler

Nicht vorhanden.

Konfigurationsmember

Clear()

Clear()

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

Referenz

configSections-Element (allgemeines Einstellungsschema)

sectionGroup-Element für configSections (allgemeines Einstellungsschema)

section-Element für configSections (allgemeines Einstellungsschema)

remove-Element für configSections (allgemeines Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

Konzepte

ASP.NET-Konfigurationsdateihierarchie und Vererbung

Bearbeiten von ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurationsszenarios

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

ASP.NET-Konfigurationsdateien

ASP.NET-Websiteverwaltung

ASP.NET-Konfigurations-API