Elemento <section>

  • Artículo

Contiene una declaración de sección de configuración.

<configuración>
  <configSections>
    <section>

<configuración>
  <configSections>
    <sectionGroup>
      <section>

Sintaxis

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

Atributos necesarios

Descripción
name Especifica el nombre de la sección de configuración.
type Especifica el nombre de la clase de manipulador de sección de configuración que lee la sección del archivo de configuración. El valor de tipo tiene la sintaxis "nombre-de-clase-de-sección-completo, nombre-simple-de-ensamblado". El nombre simple de ensamblado es el nombre de archivo raíz sin la extensión de archivo .dll.

Atributos opcionales

Los atributos siguientes solo se aplican a las aplicaciones de ASP.NET. El sistema de configuración omite estos atributos para los demás tipos de aplicación.

Descripción
allowDefinition Especifica en qué archivo de configuración se puede usar la sección. Utilice uno de los valores siguientes:

En todas partes
Permite usar la sección en cualquier archivo de configuración. Este es el valor predeterminado.
MachineOnly
Permite usar la sección solo en el archivo de configuración de la máquina (Machine.config).
MachineToApplication
Permite usar la sección en el archivo de configuración de máquina o en el archivo de configuración de la aplicación.
allowLocation Determina si la sección se puede usar dentro del elemento <location>. Utilice uno de los valores siguientes:

true
Permite usar la sección dentro del elemento <location>. Este es el valor predeterminado.
false
No permite usar la sección dentro del elemento <location>.

Elementos primarios

Descripción
<configSections> Elemento Contiene declaraciones de espacio de nombres y sección de configuración.
Elemento <sectionGroup> Define un espacio de nombres para las secciones de configuración.

Nota:

Un elemento <section> es un elemento secundario de <configSections> o <sectionGroup>, pero no de ambos.

Elementos secundarios

None

Observaciones

Declarar una sección de configuración básicamente define un nuevo elemento para el archivo de configuración. El nuevo elemento contiene la configuración que lee un manipulador de sección de configuración (es decir, una clase que implementa la interfaz IConfigurationSectionHandler). Los atributos y los elementos secundarios de una sección que defina dependen del manipulador de la sección que use para leer la configuración.

Declarar un manipulador de sección de configuración en el archivo Machine.config permite usar la sección de configuración en cualquier archivo de configuración de aplicación de ese equipo, a menos que el atributo allowDefinition especifique lo contrario.

Ejemplo

En el ejemplo siguiente se muestran cómo se define una sección de configuración y los valores de esa sección:

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

Archivo de configuración

Este elemento se puede usar en el archivo de configuración de la aplicación, el archivo de configuración de la máquina (Machine.config) y los archivos Web.config que no están en el nivel de directorio de la aplicación.

Consulte también