Élément personnalisé pour NameValueSectionHandler et DictionarySectionHandler

Article
04/11/2008

Définit des paramètres pour des sections de configuration personnalisées qui utilisent les classes NameValueSectionHandler ou DictionarySectionHandler.

<configuration>
** <sectionName>**

<sectionName> </sectionName>

Éléments enfants

Élément	Description
<add>, élément de NameValueSectionHandler et DictionarySectionHandler	Ajoute des paramètres personnalisés.
<remove>, élément de NameValueSectionHandler et DictionarySectionHandler	Supprime un paramètre défini précédemment.
<clear>, élément de NameValueSectionHandler et DictionarySectionHandler	Efface tous les paramètres définis précédemment dans une section.

Notes

L'élément <sectionName> est un élément personnalisé défini par une balise <section> dans l'élément <configSections>.

Le tableau suivant montre le type d'objet retourné par la méthode ConfigurationSettings.GetConfig pour chaque gestionnaire de sections de configuration.

Gestionnaire de sections de configuration	Type de retour
DictionarySectionHandler	Systems.Collections.IDictionary
NameValueSectionHandler	Systems.Collections.Specialized.NameValueCollection

Exemple

L'exemple suivant montre comment déclarer les sections qui utilisent les classes DictionarySectionHandler et NameValueSectionHandler. Les éléments personnalisés sont <dictionarySample>, qui contient les paramètres lus par la classe DictionarySectionHandler, et <mySection>, qui contient les paramètres lus par la classe NameValueSectionHandler.

<configuration>
   <configSections>
      <section name="dictionarySample"
         type="System.Configuration.DictionarySectionHandler,System"/>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler,System" />
      </sectionGroup>
   </configSections>
   <dictionarySample>
      <add key="myKey" value="myValue"/>
   </dictionarySample>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</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

Schéma des sections de configuration | Paramètres des sections de configuration

Partager via