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

Artikel
03/31/2008

Entfernt einen vordefinierten Abschnitt oder eine vordefinierte Abschnittsgruppe.

<configuration>
<configSections>
<remove>

<remove name="section name or section group name" />

Erforderliche Attribute

Attribut	Beschreibung
name	Gibt den Namen des zu entfernenden Abschnitts bzw. der zu entfernenden Abschnittsgruppe an.

Hinweise

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

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie mit einem <remove>-Element in einer Anwendungskonfigurationsdatei einen Abschnitt löschen können, der zuvor in der Konfigurationsdatei des Computers definiert worden war.

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

<!-- Machine.config file. -->
<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

Der folgende Code für eine Anwendungskonfigurationsdatei entfernt den <sampleSection>-Abschnitt. Nach dem Entfernen des Abschnitts kann die Anwendung die Einstellungen aus <sampleSection> nicht mehr abrufen.

<!-- Application configuration file. -->
<configuration>
   <configSections>
      <remove name="sampleSection"/>
   </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

Freigeben über