configSections, élément (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.]

Spécifie une section de configuration et des déclarations d'espace de noms.

   <configSections>
      <section />
      <sectionGroup />
      <remove />
      <clear/>
   </configSections>

Attributs et éléments

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

Attributs

Aucun

Éléments enfants

Élément	Description
clear	Supprime toutes les références aux sections et aux groupes de sections hérités, n'autorisant que les sections et groupes de sections ajoutés par les éléments section et sectionGroup actuels.
remove	Supprime une référence à une section et à un groupe de sections hérités.
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.

Notes

L'élément configSections spécifie les déclarations de section de configuration et de gestionnaire. Cela est nécessaire parce qu'ASP.NET ne fait pas de suppositions 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 un élément ou une section de configuration et la classe dérivée de ConfigurationSection qui gère l'élément ou la section 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.

Si l'élément configSections figure dans un fichier de configuration, l'élément configSections doit être le premier élément enfant de l'élément configuration.

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éfinir une section de configuration personnalisée et les paramètres de cette section.

<configuration>

   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1="Value1" 
                  setting2="value two" 
                  setting3="third value" />

</configuration>

Informations sur les éléments

Gestionnaire de section de configuration	Non applicable.
Membre de configuration	ConfigurationSectionCollection ConfigurationSectionGroupCollection
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 1.0, 1.1 ou 2.0 Microsoft Visual Studio 2003 ou Visual Studio 2005

Voir aussi