<section>-Element
Enthält eine Konfigurationsabschnittsdeklaration.
<configuration>
<configSections>
<section>
<configuration>
<configSections>
<sectionGroup>
<section>
Syntax
<section name="section name"
type="configuration section handler class, assembly"
allowDefinition="Everywhere|MachineOnly|MachineToApplication"
allowLocation="true|false" />
Erforderliche Attribute
| BESCHREIBUNG | |
|---|---|
| name | Gibt den Namen des Konfigurationsabschnitts an. |
| type | Gibt den Namen der Handlerklasse für den Konfigurationsabschnitt an, die den Abschnitt aus der Konfigurationsdatei liest. Der type-Wert weist die Syntax „vollqualifizierter-Name-der-Abschnittshandler_Klasse, einfacher-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.
| BESCHREIBUNG | |
|---|---|
| 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 jeder Konfigurationsdatei. Dies ist die Standardoption. 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: true Gestattet die Verwendung des Abschnitts innerhalb des <location>-Elements. Dies ist die Standardoption. false Untersagt die Verwendung des Abschnitts innerhalb des <location>-Elements. |
Übergeordnete Elemente
| BESCHREIBUNG | |
|---|---|
| <configSections>-Element | Enthält Konfigurationsabschnitts- und Namespacedeklarationen. |
| <sectionGroup>-Element | Definiert einen Namespace für Konfigurationsabschnitte. |
Hinweis
Ein <section>-Element ist ein untergeordnetes Element von <configSections> oder <sectionGroup>, aber nicht von beiden.
Untergeordnete Elemente
Keine
Bemerkungen
Beim 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.
Wenn Sie einen Konfigurationsabschnittshandler in der Machine.config-Datei deklarieren, können Sie den Konfigurationsabschnitt in jeder Anwendungskonfigurationsdatei auf diesem Computer verwenden, es sei denn, das allowDefinition-Attribut gibt etwas anderes an.
Beispiel
Das folgende Beispiel zeigt, wie Sie einen Konfigurationsabschnitt sowie 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, der Computerkonfigurationsdatei (Machine.config) und in Web.config-Dateien verwendet werden, die sich nicht auf der Ebene des Anwendungsverzeichnisses befinden.
