sectionGroup-Element für configSections (allgemeines Einstellungsschema)

Artikel
09/03/2008

Aktualisiert: November 2007

Definiert eine Zuordnung zwischen einem Konfigurationsabschnittshandler und einem Konfigurationsabschnitt.

configuration-Element (allgemeines Einstellungsschema)
  configSections-Element (allgemeines Einstellungsschema)
    sectionGroup-Element für configSections (allgemeines Einstellungsschema)
      configuration-Element (allgemeines Einstellungsschema)
        configSections-Element (allgemeines Einstellungsschema)
          sectionGroup-Element für configSections (allgemeines Einstellungsschema)
            sectionGroup-Element für configSections (allgemeines Einstellungsschema)

<sectionGroup 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token"
   <section />
/>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente sowie übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
name	Erforderliches String-Attribut. Gibt den Namen des Konfigurationsabschnitts oder Konfigurationselements an, das dem im type-Attribut angegebenen Konfigurationsabschnittshandler zugeordnet ist. Der Name des group-Elements muss genau so angegeben werden, wie er auch im Bereich der Abschnittseinstellungen der Konfigurationsdatei verwendet wird.
type	Erforderliches String-Attribut. Gibt den Namen der Konfigurationsabschnitts-Handlerklasse für die Verarbeitung der Konfigurationseinstellungen an, die in dem im name-Attribut angegebenen Abschnitt oder Element enthalten sind. Verwenden Sie folgendes Format: type="Vollqualifizierter Klassenname,Name der Assemblydatei,Version,Kultur,öffentliches Schlüsseltoken" Die Definition muss mit dem Assemblyverweis übereinstimmen. Wenn beispielsweise die im folgenden Codebeispiel angegebene Versionsnummer nicht mit der Assembly übereinstimmt, tritt ein Fehler auf. `type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"` Die Assemblydatei muss sich im gleichen Anwendungsverzeichnis befinden wie die Datei Web.config, durch die sie definiert ist. Falls es sich dabei um die Stammdatei Web.config oder die Datei Machine.config handelt, muss sich die Assembly im Verzeichnis %SystemRoot%\Microsoft.NET\Framework\Version befinden.

Attribut

Beschreibung

name

Erforderliches String-Attribut.

Gibt den Namen des Konfigurationsabschnitts oder Konfigurationselements an, das dem im type-Attribut angegebenen Konfigurationsabschnittshandler zugeordnet ist. Der Name des group-Elements muss genau so angegeben werden, wie er auch im Bereich der Abschnittseinstellungen der Konfigurationsdatei verwendet wird.

type

Erforderliches String-Attribut.

Gibt den Namen der Konfigurationsabschnitts-Handlerklasse für die Verarbeitung der Konfigurationseinstellungen an, die in dem im name-Attribut angegebenen Abschnitt oder Element enthalten sind. Verwenden Sie folgendes Format:

type="Vollqualifizierter Klassenname,Name der Assemblydatei,Version,Kultur,öffentliches Schlüsseltoken"

Die Definition muss mit dem Assemblyverweis übereinstimmen. Wenn beispielsweise die im folgenden Codebeispiel angegebene Versionsnummer nicht mit der Assembly übereinstimmt, tritt ein Fehler auf.

type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"

Die Assemblydatei muss sich im gleichen Anwendungsverzeichnis befinden wie die Datei Web.config, durch die sie definiert ist. Falls es sich dabei um die Stammdatei Web.config oder die Datei Machine.config handelt, muss sich die Assembly im Verzeichnis %SystemRoot%\Microsoft.NET\Framework\Version befinden.

Untergeordnete Elemente

Element	Beschreibung
section	Definiert eine Zuordnung zwischen einem Konfigurationsabschnittshandler und einem Konfigurationselement.
sectionGroup	Definiert eine Zuordnung zwischen einem Konfigurationsabschnittshandler und einem Konfigurationsabschnitt.

Übergeordnete Elemente

Element	Beschreibung
configuration	Gibt das erforderliche Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
configSections	Legt Konfigurationsabschnitts- und Namespacedeklarationen fest.
sectionGroup	Definiert eine Zuordnung zwischen einem Konfigurationsabschnittshandler und einem Konfigurationsabschnitt.

Hinweise

Das sectionGroup-Element fungiert als Container für section-Elemente. Ein section-Element stellt die Zuordnung zwischen einem Konfigurationsabschnittshandler und einem Konfigurationselement oder -abschnitt her. Dies ist erforderlich, da ASP.NET keine Annahmen zur Behandlung der Einstellungen in einer Konfigurationsdatei trifft. Stattdessen überlässt ASP.NET die Verarbeitung der Konfigurationsdaten den Konfigurationsabschnittshandlern. Jedes section-Element bezeichnet einen Konfigurationsabschnitt oder ein Konfigurationselement sowie die zugeordnete Klasse, die von der ConfigurationSection-Klasse abgeleitet ist und den Konfigurationsabschnitt oder das Konfigurationselement bearbeitet. section-Elemente können mithilfe von sectionGroup-Elementen logisch gruppiert werden, um die section-Elemente zu ordnen und Namenskonflikte zu vermeiden. Das section-Element und das sectionGroup-Element sind im configSections-Element enthalten.

Standardkonfiguration

Die Konfigurationsabschnitte für die .NET Framework-Konfigurationselemente werden in der Datei Machine.config definiert und sind zu zahlreich, um an dieser Stelle aufgelistet zu werden. Im folgenden Ausschnitt aus der Datei Machine.config wird der Konfigurationsabschnittshandler für das authentication-Element des system.web-Abschnitts definiert. Anschließend werden die Konfigurationseinstellungen für das authentication-Element festgelegt.

Wenn ein Konfigurationsabschnittshandler keinem Konfigurationselement zugeordnet wurde, zeigt ASP.NET den Serverfehler "Unbekannter Konfigurationsabschnitt element_name" an.

<configuration>
    <configSections>
        <sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
            <section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
            <!-- Other system.web sections -->
        </sectionGroup>
        <!-- Other configuration sections -->
    </configSections>

    <system.web>
        <authentication mode="Windows">
            <forms name=".ASPXAUTH" 
                   loginUrl="login.aspx" defaultUrl="default.aspx" 
                   protection="All" 
                   timeout="30" 
                   path="/" 
                   requireSSL="False" 
                   slidingExpiration="True" 
                   cookieless="UseCookies" 
                   domain="" 
                   enableCrossAppRedirects="False">
                <credentials passwordFormat="SHA1" />
            </forms>
            <passport redirectUrl="internal" />
        </authentication>
        <!-- Other system.web elements -->
    </system.web>
    <!-- Other configuration settings -->
</configuration>

Beispiel

Das folgende Codebeispiel veranschaulicht, wie Sie eine Abschnittsgruppe sowie Abschnitte innerhalb einer Abschnittsgruppe deklarieren.

<configuration>
   <configSections>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler" />
      </sectionGroup>
   </configSections>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

Elementinformationen

Konfigurationsabschnittshandler	Nicht vorhanden.
Konfigurationsmember	ConfigurationSectionGroup
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene Web.config auf der Ebene virtueller oder physischer Verzeichnisse
Anforderungen	Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 .NET Framework, Version 2.0 Microsoft Visual Studio 2003 oder Visual Studio 2005

Siehe auch

Freigeben über