Elemento sectionGroup para configSections (Esquema de configuración general)

Artículo
08/10/2011

Define una asociación entre un controlador de sección de configuración y una sección de configuración.

<sectionGroup 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token">
   <section />
/>

Atributos y elementos

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

Atributos

Atributo	Descripción
name	El atributo String es obligatorio. Especifica el nombre de la sección o elemento de configuración asociado al controlador de sección de configuración que especifica el atributo type. Éste es el nombre del elemento group que aparece en el área de configuración de sección del archivo de configuración.
type	El atributo String es obligatorio. Especifica el nombre de la clase del controlador de sección de configuración que controla el procesamiento de los valores de configuración que se encuentran en la sección o el elemento especificado en el atributo name. Utilice el formato siguiente: type="Nombre de clase completo, nombre de archivo de ensamblado, versión, referencia cultural, token de clave pública" La definición debe coincidir con la referencia de ensamblado. Por ejemplo, si el número de versión del ejemplo de código siguiente no coincide con el ensamblado, se produce un error. `type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"` El archivo de ensamblado se debe encontrar en el mismo directorio de aplicación que el archivo Web.config que lo define. En el caso del archivo Machine.config o Web.config raíz, el archivo de ensamblado debe estar en el directorio %SystemRoot%\Microsoft.NET\Framework\versión.

Atributo

Descripción

name

El atributo String es obligatorio.

Especifica el nombre de la sección o elemento de configuración asociado al controlador de sección de configuración que especifica el atributo type. Éste es el nombre del elemento group que aparece en el área de configuración de sección del archivo de configuración.

type

El atributo String es obligatorio.

Especifica el nombre de la clase del controlador de sección de configuración que controla el procesamiento de los valores de configuración que se encuentran en la sección o el elemento especificado en el atributo name. Utilice el formato siguiente:

type="Nombre de clase completo, nombre de archivo de ensamblado, versión, referencia cultural, token de clave pública"

La definición debe coincidir con la referencia de ensamblado. Por ejemplo, si el número de versión del ejemplo de código siguiente no coincide con el ensamblado, se produce un error.

type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"

El archivo de ensamblado se debe encontrar en el mismo directorio de aplicación que el archivo Web.config que lo define. En el caso del archivo Machine.config o Web.config raíz, el archivo de ensamblado debe estar en el directorio %SystemRoot%\Microsoft.NET\Framework\versión.

Elementos secundarios

Elemento	Descripción
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.
configSections	Especifica las declaraciones de las secciones de configuración y del espacio de nombres.
sectionGroup	Define una asociación entre un controlador de sección de configuración y una sección de configuración.

Comentarios

El elemento sectionGroup actúa como contenedor de elementos section. Un elemento section asocia un controlador de la sección de configuración a un elemento de configuración o sección. Es necesario porque ASP.NET no hace ninguna suposición sobre cómo controlar los valores incluidos en 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 una sección o elemento de configuración y la clase asociada que se deriva de la clase ConfigurationSection que controla la sección o el elemento de configuración. Los elementos section se pueden agrupar lógicamente en elementos sectionGroup para organizar los elementos section y evitar conflictos de nomenclatura. Los elementos section y sectionGroup están contenidos en el elemento configSections.

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 siguiente ejemplo de código se muestra cómo declarar un grupo de secciones y cómo declarar las secciones del grupo.

<configuration>
   <configSections>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler" />
      </sectionGroup>
   </configSections>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

Información de elemento

Controlador de la sección de configuración	No procede.
Miembro de configuración	ConfigurationSectionGroup
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 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también