Elemento <section>

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

<configuration>
   <configSections>
      <section>

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

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

Atributos requeridos

Atributo	Descripción
name	Especifica el nombre de la sección de configuración.
type	Especifica el nombre de la clase de controlador de la sección de configuración que lee la sección en el archivo de configuración.

Atributos opcionales

Los siguientes atributos sólo se pueden utilizar en las aplicaciones ASP.NET. El sistema de configuración omite estos atributos cuando se ejecutan otras aplicaciones.

Atributo	Descripción
allowDefinition	Especifica el archivo de configuración en el que se puede utilizar la sección. Use uno de los valores siguientes: Everywhere Permite utilizar la sección en cualquier archivo de configuración. Éste es el valor predeterminado. MachineOnly Permite utilizar la sección sólo en el archivo de configuración del equipo (Machine.config). MachineToApplication Permite utilizar la sección en el archivo de configuración del equipo o en el archivo de configuración de la aplicación.
allowLocation	Determina si la sección se puede utilizar en el elemento <location>. Utilice uno de los siguientes valores: true Permite utilizar la sección en el elemento <location>. Éste es el valor predeterminado. false No permite utilizar la sección en el elemento.

Comentarios

Cuando se declara una sección de configuración, fundamentalmente se define un nuevo elemento en el archivo de configuración. El nuevo elemento contiene los valores que lee el controlador de una sección de configuración (es decir, una clase que implementa la interfaz IConfigurationSectionHandler). Los atributos y los elementos secundarios de la sección definida están en función del controlador de sección utilizado para leer los valores.

Al declarar un controlador de sección de configuración en el archivo Machine.config, se puede utilizar la sección de configuración en cualquier archivo de configuración de la aplicación de ese equipo, siempre que en el atributo allowDefinition no se especifique lo contrario.

Ejemplo

En el siguiente ejemplo se muestra cómo definir 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 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

Elemento personalizado para NameValueSectionHandler y DictionarySectionHandler | Elemento personalizado para SingleTagSectionHandler | Valores de la sección de configuración | Elemento <sectionGroup> | Esquema de secciones de configuración