Partager via

<section>, élément

  • Article

Contient une déclaration de section de configuration.

<configuration>
   <configSections>
      <section>

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

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

Attributs requis

Attribut Description
name Spécifie le nom de la section de configuration.
type Spécifie le nom de la classe gestionnaire des sections de configuration qui lit la section dans le fichier de configuration.

Attributs facultatifs

Les attributs suivants s'appliquent uniquement aux applications ASP.NET. Le système de configuration ignore ces attributs lorsque d'autres types d'applications sont exécutés.

Attribut Description
allowDefinition Spécifie le fichier de configuration dans lequel la section peut être utilisée. Utilisez l'une des valeurs suivantes :
Everywhere
La section peut être utilisée dans n'importe quel fichier de configuration. Il s'agit de la valeur par défaut.
MachineOnly
La section peut être utilisée uniquement dans le fichier de configuration de l'ordinateur (Machine.config).
MachineToApplication
La section peut être utilisée dans le fichier de configuration de l'ordinateur ou dans le fichier de configuration de l'application.
allowLocation Détermine si la section peut être utilisée dans l'élément <location>. Utilisez l'une des valeurs suivantes :
true
La section peut être utilisée dans l'élément <location>. Il s'agit de la valeur par défaut.
false
La section ne peut pas être utilisée dans l'élément <location>.

Notes

Déclarer une section de configuration permet essentiellement de définir un nouvel élément pour le fichier de configuration. Le nouvel élément contient les paramètres qui seront lus par un gestionnaire de sections de configuration (c'est-à-dire une classe qui implémente l'interface IConfigurationSectionHandler). Les attributs et les éléments enfants d'une section que vous définissez dépendent du gestionnaire de sections que vous utilisez pour lire vos paramètres.

Déclarer un gestionnaire de sections de configuration dans le fichier Machine.config vous permet d'utiliser la section de configuration dans tout fichier de configuration de l'application présent sur cet ordinateur, sauf spécification contraire de l'attribut allowDefinition.

Exemple

L'exemple suivant montre comment définir une section de configuration et ses paramètres.

<configuration>
   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" 
               allowLocation="false"/>
   </configSections>
   <sampleSection setting1="Value1" setting2="value two" 
                  setting3="third value" />
</configuration>

Fichier de configuration

Cet élément peut être utilisé dans le fichier de configuration de l'application, dans le fichier de configuration de l'ordinateur (Machine.config) et dans les fichiers Web.config qui ne se trouvent pas au niveau du répertoire de l'application.

Voir aussi

Élément personnalisé pour NameValueSectionHandler et DictionarySectionHandler | Élément personnalisé pour SingleTagSectionHandler | Paramètres des sections de configuration | <sectionGroup>, élément | Schéma des sections de configuration