Benutzerdefiniertes Element für "NameValueSectionHandler" und "DictionarySectionHandler"

Definiert Einstellungen für benutzerdefinierte Konfigurationsabschnitte, die die NameValueSectionHandler-Klasse oder die DictionarySectionHandler-Klasse verwenden.

<configuration>
**   <sectionName>**

<sectionName> </sectionName>

Untergeordnete Elemente

Hinweise

Das <sectionName>-Element ist ein benutzerdefiniertes Element, das durch ein <section>-Tag im <configSections>-Element definiert wird.

Die folgende Tabelle zeigt, welchen Objekttyp die ConfigurationSettings.GetConfig-Methode für jeden Konfigurationsabschnittshandler zurückgibt.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie Abschnitte deklarieren, die die DictionarySectionHandler-Klasse und die NameValueSectionHandler-Klasse verwenden. Die benutzerdefinierten Elemente sind <dictionarySample>, welches Einstellungen enthält, die von der DictionarySectionHandler-Klasse gelesen werden, und <mySection>. Dieses enthält Einstellungen, die von der NameValueSectionHandler-Klasse gelesen werden.

<configuration>
   <configSections>
      <section name="dictionarySample"
         type="System.Configuration.DictionarySectionHandler,System"/>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler,System" />
      </sectionGroup>
   </configSections>
   <dictionarySample>
      <add key="myKey" value="myValue"/>
   </dictionarySample>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</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