<section>-Element

Artikel
03/31/2008

Enthält eine Konfigurationsabschnittsdeklaration.

<configuration>
<configSections>
<section>

<configuration>
   <configSections>
      <sectionGroup>
         <section>

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

Erforderliche Attribute

Attribut	Beschreibung
name	Gibt den Namen des Konfigurationsabschnitts an.
type	Gibt den Namen der Konfigurationsabschnittshandler-Klasse an, die den Abschnitt aus der Konfigurationsdatei liest.

Optionale Attribute

Die folgenden Attribute gelten nur für ASP.NET-Anwendungen. Das Konfigurationssystem ignoriert diese Attribute, wenn andere Typen von Anwendungen ausgeführt werden.

Attribut	Beschreibung
allowDefinition	Gibt an, in welcher Konfigurationsdatei der Abschnitt eingesetzt werden kann. Verwenden Sie einen der folgenden Werte: Everywhere Der Abschnitt kann in einer beliebigen Konfigurationsdatei verwendet werden. Dies ist die Standardeinstellung. MachineOnly Der Abschnitt kann nur in der Konfigurationsdatei des Computers (Machine.config) verwendet werden. MachineToApplication Der Abschnitt kann in der Konfigurationsdatei des Computers oder in der Anwendungskonfigurationsdatei verwendet werden.
allowLocation	Gibt an, ob der Abschnitt innerhalb des <location>-Elements eingesetzt werden kann. Verwenden Sie einen der folgenden Werte: true Der Abschnitt kann innerhalb des <location>-Elements verwendet werden. Dies ist die Standardeinstellung. false Der Abschnitt kann nicht innerhalb des <location>-Elements verwendet werden.

allowDefinition

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

Everywhere: Der Abschnitt kann in einer beliebigen Konfigurationsdatei verwendet werden. Dies ist die Standardeinstellung.
MachineOnly: Der Abschnitt kann nur in der Konfigurationsdatei des Computers (Machine.config) verwendet werden.
MachineToApplication: Der Abschnitt kann in der Konfigurationsdatei des Computers oder in der Anwendungskonfigurationsdatei verwendet werden.

allowLocation

Gibt an, ob der Abschnitt innerhalb des <location>-Elements eingesetzt werden kann. Verwenden Sie einen der folgenden Werte:

true: Der Abschnitt kann innerhalb des <location>-Elements verwendet werden. Dies ist die Standardeinstellung.
false: Der Abschnitt kann nicht innerhalb des <location>-Elements verwendet werden.

Hinweise

Beim Deklarieren eines Konfigurationsabschnitts wird im Grunde ein neues Element für die Konfigurationsdatei definiert. Das neue Element enthält Einstellungen, die von einem Konfigurationsabschnittshandler (d. h. von einer Klasse, die die IConfigurationSectionHandler-Schnittstelle implementiert) gelesen wird. Die Attribute und untergeordneten Elemente des zu definierenden Abschnitts hängen von dem Abschnittshandler ab, den Sie zum Lesen der Einstellungen verwenden.

Durch Deklarieren eines Konfigurationsabschnittshandlers in der Datei Machine.config können Sie den Konfigurationsabschnitt in einer beliebigen Anwendungskonfigurationsdatei auf dem betreffenden Computer verwenden, sofern das allowDefinition-Attribut nichts Anderes angibt.

Beispiel

Das folgende Beispiel veranschaulicht, wie Sie einen Konfigurationsabschnitt definieren und Einstellungen für diesen Abschnitt festlegen.

<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 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

Benutzerdefiniertes Element für "NameValueSectionHandler" und "DictionarySectionHandler" | Benutzerdefiniertes Element für "SingleTagSectionHandler" | Einstellungen für Konfigurationsabschnitte | <sectionGroup>-Element | Schema für Konfigurationsabschnitte

Freigeben über