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

Artikel
03/31/2008

Entfernt eine zuvor definierte Einstellung.

<configuration>
** <sectionName>**
** <remove>**

<remove key="predefened setting key"/>

Erforderliche Attribute

Attribut	Beschreibung
key	Gibt den Schlüsselnamen der zu entfernenden Einstellung an.

Hinweise

Mit dem <remove>-Element können Sie Einstellungen aus einer Anwendung entfernen, die auf einer höheren Ebene in der Konfigurationsdateihierarchie definiert wurden.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie mit dem <remove>-Element in einer Anwendungskonfigurationsdatei Einstellungen entfernen 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 und fügt zwei Einstellungen in diesen ein: key1 und key2.

<!-- 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 entfernt die key2-Einstellung aus <mySection>.

<!--Application configuration file. -->
<configuration>
   <mySection>
      <remove key="key2"/>
   </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

Freigeben über