Freigeben über

clear-Element für configSections (allgemeines Einstellungsschema)

  • Artikel

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

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 sowie untergeordnete 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 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)

remove-Element für configSections (allgemeines Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

Konzepte

ASP.NET Configuration File Hierarchy

Format of ASP.NET Configuration Files

Configuration Inheritance

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

ASP.NET Configuration Files

Configuring ASP.NET Applications

ASP.NET Configuration API