sectionGroup, élément de configSections (Schéma des paramètres généraux)

Article
05/27/2012

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Définit une association entre un gestionnaire de section de configuration et une section de configuration.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
name	Attribut String requis. Spécifie le nom de la section ou de l'élément de configuration associé au gestionnaire de section de configuration qui est spécifié par l'attribut type. Il s'agit du nom de l'élément group tel qu'il apparaît dans la zone des paramètres de sections du fichier de configuration.
type	Attribut String requis. Spécifie le nom de la classe du gestionnaire de section de configuration qui gère le traitement des paramètres de configuration présents dans la section ou l'élément spécifié dans l'attribut name. Utilisez le format suivant : type="nom de classe qualifié complet, nom de fichier d'assembly, version, culture, jeton de clé publique" La définition doit correspondre à la référence d'assembly. Par exemple, si le numéro de version dans l'exemple de code suivant ne correspond pas à l'assembly, une erreur se produit. `type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"` Le fichier d'assembly doit se trouver dans le même répertoire d'application que le fichier Web.config qui le définit. Dans le cas du fichier Web.config racine ou du fichier Machine.config, le fichier d'assembly doit être dans le répertoire %SystemRoot%\Microsoft.NET\Framework\version.

Attribut

Description

name

Attribut String requis.

Spécifie le nom de la section ou de l'élément de configuration associé au gestionnaire de section de configuration qui est spécifié par l'attribut type. Il s'agit du nom de l'élément group tel qu'il apparaît dans la zone des paramètres de sections du fichier de configuration.

type

Attribut String requis.

Spécifie le nom de la classe du gestionnaire de section de configuration qui gère le traitement des paramètres de configuration présents dans la section ou l'élément spécifié dans l'attribut name. Utilisez le format suivant :

type="nom de classe qualifié complet, nom de fichier d'assembly, version, culture, jeton de clé publique"

La définition doit correspondre à la référence d'assembly. Par exemple, si le numéro de version dans l'exemple de code suivant ne correspond pas à l'assembly, une erreur se produit.

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

Le fichier d'assembly doit se trouver dans le même répertoire d'application que le fichier Web.config qui le définit. Dans le cas du fichier Web.config racine ou du fichier Machine.config, le fichier d'assembly doit être dans le répertoire %SystemRoot%\Microsoft.NET\Framework\version.

Éléments enfants

Élément	Description
section	Définit une association entre un gestionnaire de section de configuration et un élément de configuration.
sectionGroup	Définit une association entre un gestionnaire de section de configuration et une section de configuration.

Éléments parents

Élément	Description
configuration	Spécifie l'élément racine requis dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
configSections	Spécifie une section de configuration et des déclarations d'espace de noms.
sectionGroup	Définit une association entre un gestionnaire de section de configuration et une section de configuration.

Notes

L'élément sectionGroup agit comme un conteneur pour les éléments section. Un élément section associe un gestionnaire de section de configuration à un élément ou une section de configuration. Cela est nécessaire parce qu'ASP.NET ne fait aucune supposition quant à la gestion de paramètres dans un fichier de configuration. Au lieu de cela, ASP.NET délègue le traitement des données de configuration aux gestionnaires de section de configuration. Chaque élément section identifie une section ou un élément de configuration et la classe associée dérivée de la classe ConfigurationSection qui gère la section ou l'élément de configuration. Les éléments section peuvent être groupés logiquement dans des éléments sectionGroup pour organiser les éléments section et éviter des conflits de noms. Les éléments section et sectionGroup sont contenus dans l'élément configSections.

Configuration par défaut

Les sections de configuration des éléments de configuration .NET sont définies dans le fichier Machine.config et sont trop nombreuses pour être répertoriées ici. L'extrait du fichier Machine.config suivant définit le gestionnaire de section de configuration de l'élément authentication de la section system.web. Ensuite, les paramètres de configuration sont définis pour l'élément authentication.

Si un gestionnaire de section de configuration n'est pas associé à un élément de configuration, ASP.NET publie l'erreur de serveur « Section de configuration non reconnue nom_élément ».

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

Exemple

L'exemple de code suivant montre comment déclarer un groupe de sections et déclarer des sections dans un groupe de sections.

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

Informations sur les éléments

Gestionnaire de section de configuration	Non applicable.
Membre de configuration	ConfigurationSectionGroup
Emplacements configurables	Machine.config Web.config racine Web.config au niveau de l'application Web.config de niveau répertoire virtuel ou physique
Configuration requise	Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 .NET Framework version 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi

Partager via