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

Artículo
10/07/2008

Actualización: noviembre 2007

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

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

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

Atributos y elementos

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

Atributos

Atributo	Descripción
name	Atributo String requerido. 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	Atributo String requerido. 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 del 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

Atributo String requerido.

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

Atributo String requerido.

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 del 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 la sección de configuración y las declaraciones de 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. Los elementos section asocian un controlador de de sección de configuración a un elemento o sección de configuració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 su lugar, 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 se incluyen en el elemento configSections.

Configuración predeterminada

Las secciones de configuración de los elementos de configuración de .NET se definen en el archivo Machine.config. Debido a que son muy numerosas, no se pueden incluir en este documento. El siguiente es un extracto del archivo Machine.config que 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) 5.0, 5.1 ó 6.0 .NET Framework 2.0 Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Compartir a través de