Elemento configSections (Esquema de configuración general)

Artículo
08/10/2011

Especifica las declaraciones de las secciones de configuración y del espacio de nombres.

   <configSections>
      <section />
      <sectionGroup />
      <remove />
      <clear/>
   </configSections>

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Ninguno.

Elementos secundarios

Elemento	Descripción
clear	Quita todas las referencias a secciones y grupos de sección heredados, y sólo permite las secciones y los grupos de sección agregados por los elementos section y sectionGroup actuales.
remove	Quita una referencia a una sección y un grupo de secciones heredados.
section	Define una asociación entre un controlador de sección de configuración y un elemento de configuración.
sectionGroup	Define una asociación entre un controlador de sección de configuración y una sección de configuración.

Elementos primarios

Elemento	Descripción
configuration	Especifica el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.

Comentarios

El elemento configSections especifica las declaraciones de las secciones de configuración y los controladores. Es obligatorio porque ASP.NET no hace ninguna suposición sobre cómo controlar los valores de un archivo de configuración. En lugar de ello, ASP.NET delega el procesamiento de los datos de configuración en los controladores de sección de configuración.

Cada elemento section identifica un elemento o una sección de configuración y la clase asociada derivada de ConfigurationSection que controla el elemento o la sección de configuración. Los elementos section pueden agruparse de manera lógica en elementos sectionGroup para organizar los elementos section y evitar conflictos de nombres. Los elementos section y sectionGroup están contenidos en el elemento configSections.

Si el elemento configSections está en un archivo de configuración, el elemento configSections deberá ser el primer elemento secundario del elemento configuration.

Configuración predeterminada

Las secciones de configuración de los elementos de configuración .NET se definen en el archivo Machine.config y son demasiados para enumerarlos aquí. En el siguiente extracto del archivo Machine.config se define el controlador de sección de configuración del elemento authentication de la sección system.web. A continuación, se definen las opciones de configuración para el elemento authentication.

Si un controlador de sección de configuración no está asociado con un elemento de configuración, ASP.NET emite el error de servidor "Sección de configuración nombre_elemento no reconocida".

<configuration>
    <configSections>
        <sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
            <section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
            <!-- Other system.web sections -->
        </sectionGroup>
        <!-- Other configuration sections -->
    </configSections>

    <system.web>
        <authentication mode="Windows">
            <forms name=".ASPXAUTH" 
                   loginUrl="login.aspx" defaultUrl="default.aspx" 
                   protection="All" 
                   timeout="30" 
                   path="/" 
                   requireSSL="False" 
                   slidingExpiration="True" 
                   cookieless="UseCookies" 
                   domain="" 
                   enableCrossAppRedirects="False">
                <credentials passwordFormat="SHA1" />
            </forms>
            <passport redirectUrl="internal" />
        </authentication>
        <!-- Other system.web elements -->
    </system.web>
    <!-- Other configuration settings -->
</configuration>

Ejemplo

En el ejemplo de código siguiente se muestra cómo definir una sección de configuración personalizada y los valores de esa sección.

<configuration>

   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1="Value1" 
                  setting2="value two" 
                  setting3="third value" />

</configuration>

Información de elemento

Controlador de la sección de configuración	No procede.
Miembro de configuración	ConfigurationSectionCollection ConfigurationSectionGroupCollection
Ubicaciones configurables	Machine.config Web.config del nivel raíz Web.config del nivel de aplicaciones Web.config del nivel de directorio virtual o físico
Requisitos	Microsoft Internet Information Services (IIS) versión 5.0, 5.1 ó 6.0 .NET Framework versión 1.0, 1.1 ó 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también