Elemento personalizado para NameValueSectionHandler y DictionarySectionHandler

Define los valores de las secciones de configuración personalizadas que utilizan las clases NameValueSectionHandler o DictionarySectionHandler.

<configuration>
**   <sectionName>**

<sectionName> </sectionName>

Elementos secundarios

Elemento	Descripción
Elemento <add> para NameValueSectionHandler y DictionarySectionHandler	Agrega valores personalizados.
Elemento <remove> para NameValueSectionHandler y DictionarySectionHandler	Quita un valor definido anteriormente.
Elemento <clear> para NameValueSectionHandler y DictionarySectionHandler	Borra todos los valores definidos anteriormente en una sección.

Comentarios

El elemento <sectionName> es un elemento personalizado que se define en una etiqueta <section> del elemento <configSections>.

En la siguiente tabla se muestra el tipo de objeto que devuelve el método ConfigurationSettings.GetConfig para cada controlador de la sección de configuración.

Controlador de la sección de configuración	Tipo de valor devuelto
DictionarySectionHandler	Systems.Collections.IDictionary
NameValueSectionHandler	Systems.Collections.Specialized.NameValueCollection

Ejemplo

En el siguiente ejemplo se muestra cómo declarar las secciones que utilizan las clases DictionarySectionHandler y NameValueSectionHandler. Los elementos personalizados son <dictionarySample> que contiene los valores que lee la clase DictionarySectionHandler, y <mySection> que contiene los valores que lee la clase 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>

Archivo de configuración

Este elemento se puede utilizar en el archivo de configuración de la aplicación, en el archivo de configuración del equipo (Machine.config) y en los archivos Web.config que no se encuentran en el directorio de la aplicación.

Vea también

Esquema de secciones de configuración | Valores de la sección de configuración