Freigeben über

<clear>-Element für "NameValueSectionHandler" und "DictionarySectionHandler"

  • Artikel

Löscht alle zuvor definierten Einstellungen in einem Abschnitt.

<configuration>
**      <section name>**
**         <clear>**

<clear/>

Hinweise

Mit dem <clear>-Element können Sie alle Einstellungen aus einer Anwendung löschen, die 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.

Der folgende Code für eine Konfigurationsdatei des Computers deklariert den <mySection>-Abschnitt.

<!-- Machine.config file.-->
<configuration>
   <configSections>
      <section name="mySection"
         type="System.Configuration.NameValueSectionHandler,System" />
   </sectionGroup>
   </configSections>
   <mySection>
      <add key="key1" value="value1" />
      <add key="key2" value="value2" />
   </mySection>
</configuration>

Der folgende Code für eine Anwendungskonfigurationsdatei löscht alle Einstellungen aus <mySection>. Die Anwendung kann keine der Einstellungen abrufen, die im <mySection>-Abschnitt der Konfigurationsdatei des Computers deklariert worden waren.

<!-- Application configuration file. -->
<configuration>
   <mySection>
      <clear/>
   </mySection>
</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