Freigeben über

<section>-Element

Enthält eine Konfigurationsabschnittsdeklaration.

<Konfiguration>
   <Configsections>
     <Abschnitt>

<Konfiguration>
   <Configsections>
     <Sectiongroup>
       <Abschnitt>

Syntax

<section name="section name"
         type="configuration section handler class, assembly"
         allowDefinition="Everywhere|MachineOnly|MachineToApplication"
         allowLocation="true|false" />

Erforderliche Attribute

Description
name Gibt den Namen des Konfigurationsabschnitts an.
type Gibt den Namen der Konfigurationsabschnittshandlerklasse an, die den Abschnitt aus der Konfigurationsdatei liest. Der Typwert weist die Syntax "fully-qualified-section-handler-class-name, simple-assembly-name" auf. Der einfache Assemblyname ist der Stammdateiname ohne die dateierweiterung.dll .

Optionale Attribute

Die folgenden Attribute gelten nur für ASP.NET Anwendungen. Das Konfigurationssystem ignoriert diese Attribute für andere Anwendungstypen.

Description
allowDefinition Gibt an, in welcher Konfigurationsdatei der Abschnitt verwendet werden kann. Verwenden Sie einen der folgenden Werte:

Überall
Ermöglicht die Verwendung des Abschnitts in einer beliebigen Konfigurationsdatei. Dies ist die Standardeinstellung.
MachineOnly
Ermöglicht die Verwendung des Abschnitts nur in der Computerkonfigurationsdatei (Machine.config).
MachineToApplication
Ermöglicht die Verwendung des Abschnitts in der Computerkonfigurationsdatei oder der Anwendungskonfigurationsdatei.
allowLocation Bestimmt, ob der Abschnitt innerhalb des <location> Elements verwendet werden kann. Verwenden Sie einen der folgenden Werte:

STIMMT
Ermöglicht die Verwendung des Abschnitts innerhalb des <location> Elements. Dies ist die Standardeinstellung.
FALSCH
Ermöglicht die Verwendung des Abschnitts innerhalb des <location> Elements nicht.

Übergeordnete Elemente

Description
<configSections> Element Enthält Konfigurationsabschnitte und Namespacedeklarationen.
<sectionGroup> Element Definiert einen Namespace für Konfigurationsabschnitte.

Hinweis

Ein Element ist ein untergeordnetes <section> Element von einem <configSections> oder <sectionGroup> nicht beidem.

Untergeordnete Elemente

Nichts

Bemerkungen

Durch das Deklarieren eines Konfigurationsabschnitts wird im Wesentlichen ein neues Element für die Konfigurationsdatei definiert. Das neue Element enthält Einstellungen, die ein Konfigurationsabschnittshandler (d. h. eine Klasse, die die IConfigurationSectionHandler Schnittstelle implementiert) liest. Die Attribute und untergeordneten Elemente eines abschnitts, den Sie definieren, hängen vom Abschnittshandler ab, den Sie zum Lesen Ihrer Einstellungen verwenden.

Durch das Deklarieren eines Konfigurationsabschnittshandlers in der dateiMachine.config können Sie den Konfigurationsabschnitt in jeder Anwendungskonfigurationsdatei auf diesem Computer verwenden, sofern das allowDefinition Attribut nichts anderes angibt.

Example

Das folgende Beispiel zeigt, wie Sie einen Konfigurationsabschnitt definieren und Einstellungen für diesen Abschnitt definieren:

<configuration>
  <configSections>
    <section name="sampleSection"
             type="System.Configuration.SingleTagSectionHandler"
             allowLocation="false" />
  </configSections>
  <sampleSection setting1="Value1"
                 setting2="value two"
                 setting3="third value" />
</configuration>

Konfigurationsdatei

Dieses Element kann in der Anwendungskonfigurationsdatei, computerkonfigurationsdatei (Machine.config) und Web.config Dateien verwendet werden, die sich nicht auf Anwendungsverzeichnisebene befinden.

Siehe auch

  • Last updated on