Share via

Élément <section>

  • Article

Contient une déclaration de section de configuration.

<configuration>
  <configSections>
    <section>

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

Syntaxe

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

Attributs requis

Description
name Spécifie le nom de la section de configuration.
type Spécifie le nom de la classe de gestionnaire de section de configuration qui lit la section dans le fichier de configuration. La valeur de type présente la syntaxe « fully-qualified-section-handler-class-name, simple-assembly-name ». Le nom d’assembly simple correspond au nom de fichier racine sans l’extension .dll.

Attributs facultatifs

Les attributs suivants s’appliquent uniquement aux applications ASP.NET. Le système de configuration ignore ces attributs pour les autres types d’applications.

Description
allowDefinition Spécifie le fichier de configuration dans lequel la section peut être utilisée. Utilisez l’une des valeurs suivantes :

Partout
Permet l’utilisation de la section dans n’importe quel fichier de configuration. Il s’agit de la valeur par défaut.
MachineOnly
Autorise l’utilisation de la section uniquement dans le fichier de configuration de l’ordinateur (Machine.config).
MachineToApplication
Autorise l’utilisation de la section dans le fichier de configuration de l’application ou dans le fichier de configuration de l’ordinateur.
allowLocation Détermine si la section peut être utilisée dans l’élément <location>. Utilisez l’une des valeurs suivantes :

true
Autorise l’utilisation de la section dans l’élément <location>. Il s’agit de la valeur par défaut.
false
N’autorise pas l’utilisation de la section dans l’élément <location>.

Éléments parents

Description
<Élément> configSections Contient la section de configuration et les déclarations d’espace de noms.
<Élément> sectionGroup Définit un espace de noms pour les sections de configuration.

Notes

Un élément <section> est un élément enfant de <configSections> ou <de sectionGroup>, mais pas des deux.

Éléments enfants

None

Notes

La déclaration d’une section de configuration définit essentiellement un nouvel élément pour le fichier de configuration. Le nouvel élément contient des paramètres qu’un gestionnaire de section de configuration (autrement dit, une classe qui implémente l’interface IConfigurationSectionHandler) lit. Les attributs et les éléments enfants d’une section que vous définissez dépendent du gestionnaire de section que vous utilisez pour lire vos paramètres.

La déclaration d’un gestionnaire de section de configuration dans le fichier Machine.config vous permet d’utiliser la section de configuration dans n’importe quel fichier de configuration d’application sur cet ordinateur, sauf si l’attribut allowDefinition spécifie le contraire.

Exemple

L’exemple suivant montre comment définir une section de configuration et les paramètres de cette section :

<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, le fichier de configuration de l’ordinateur (Machine.config) et les fichiers Web.config qui ne sont pas au niveau du répertoire de l’application.

Voir aussi