Élément <section>
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.
