Freigeben über

<clear>-Element für "<configSections>"

  • Artikel

Löscht alle zuvor definierten Abschnitte und Abschnittsgruppen.

<configuration>
   <configSections>
**      <clear>**

<clear/>

Hinweise

Das <clear>-Element entfernt alle Abschnitte und Abschnittsgruppen aus der Anwendung, die weiter oben in der aktuellen Konfigurationsdatei oder auf einer höheren Ebene in der Konfigurationsdateihierarchie definiert wurden.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie mit einem <clear>-Element in einer Anwendungskonfigurationsdatei Abschnitte löschen können, die zuvor in der Konfigurationsdatei des Computers definiert worden waren.

Im folgenden Code für die Konfigurationsdatei des Computers werden zwei Abschnitte deklariert, <sampleSection> und <anotherSampleSection>, die vor der Anwendungskonfigurationsdatei gelesen werden.

<!-- Machine.config file. -->
<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>

Der folgende Code für eine Anwendungskonfigurationsdatei löscht alle zuvor deklarierten Abschnitte. Die Anwendung kann keine Einstellungen aus einem der Abschnitte, die in der Konfigurationsdatei des Computers deklariert worden waren, verwenden oder abrufen. Sie kann jedoch Einstellungen aus <anotherSection> verwenden, da dieser auf das <clear>-Element folgt.

<!-- Application configuration file. -->
<configuration>
   <configSections>
      <clear/>
      <section name="anotherSection"
               type="System.Configuration.NameValueSectionHandler" />
    </configSections>
</configuration>

Konfigurationsdatei

Dieses Element kann in der Konfigurationsdatei der Anwendung, der Konfigurationsdatei des Computers (Machine.config) und in den Web.config-Dateien verwendet werden, die sich nicht auf Anwendungsverzeichnisebene befinden.

Siehe auch

Schema für Konfigurationsabschnitte | Einstellungen für Konfigurationsabschnitte