Elemento <section>
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.
