¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

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

Actualización: noviembre 2007

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

Elemento configuration (Esquema de configuración general)
  Elemento configSections (Esquema de configuración general)
    Elemento section 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 section para configSections (Esquema de configuración general)

<section 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token"
   allowDefinition= "Everywhere|MachineOnly|MachineToApplication|MachineToWebRoot" 
   allowLocation="True|False" 
   restartOnExternalChanges="True|False" 
/>

Las siguientes secciones describen atributos, elementos secundarios y elementos primarios.

Atributos

Atributo

Descripción

allowDefinition

Atributo Enum opcional.

Sólo se aplica a las aplicaciones ASP.NET.

Especifica en qué archivo de configuración se puede utilizar la sección.

Este atributo puede ser uno de los valores siguientes (se define en la enumeración ConfigurationAllowDefinition), por orden de ámbito descendente.

ValorDescription
EverywherePermite configurar la sección en cualquier archivo de configuración o directorio, de la manera que sigue:
  • Machine.config

  • Web.config raíz

  • Web.config para una aplicación

  • Directorio virtual

  • Subdirectorio físico en la aplicación.

Si no se utiliza ningún atributo allowDefinition, se supone que es Everywhere. Éste es el valor predeterminado.
MachineToApplicationPermite configurar la sección en uno de los archivos siguientes:
  • Machine.config

  • Web.config raíz

  • Web.config para una aplicación.

Se excluyen los archivos Web.config de directorios virtuales o de un subdirectorio físico de la aplicación.
MachineToWebRootPermite configurar la sección en uno de los archivos siguientes:
  • Machine.config

  • Web.config raíz.

Los archivos Machine.config y Web.config raíz se encuentran en %SystemRoot%\Microsoft.NET\Framework\númeroDeVersión\CONFIG.
MachineOnlyPermite configurar la sección sólo en el archivo Machine.config, situado en %SystemRoot%\Microsoft.NET\Framework\númeroDeVersión\CONFIG.

allowExeDefinition

Atributo Enum opcional.

Sólo se aplica a las aplicaciones cliente de .NET Framework.

Especifica en qué archivo de configuración se puede utilizar la sección.

Este atributo puede ser uno de los valores siguientes (se define en la enumeración ConfigurationAllowExeDefinition), por orden de ámbito descendente.

ValorDescription
MachineToApplicationPermite configurar la sección en uno de los archivos siguientes:
  • Machine.config

  • Configuración de la aplicación.

MachineToRoamingUser
MachineToLocalUser
MachineOnlyPermite configurar la sección sólo en el archivo Machine.config, situado en %SystemRoot%\Microsoft.NET\Framework\númeroDeVersión\CONFIG.

allowLocation

Atributo Boolean opcional.

Sólo se aplica a las aplicaciones ASP.NET.

Determina si la sección se puede utilizar en el elemento location.

El valor predeterminado es True.

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 se especifica en el atributo type. Éste es el nombre del elemento que aparece en el área de configuración de sección del archivo de configuración.

restartOnExternalChanges

Atributo Boolean opcional.

No se aplica a las aplicaciones ASP.NET.

Especifica si la aplicación debe reiniciarse en caso de que cambien los datos de configuración de la sección.

type

Atributo String requerido.

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

type="Nombre de clase completo, nombre del archivo del 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 siguiente ejemplo de sintaxis no coincide con el del 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 define el archivo de ensamblado. En el caso del archivo Web.config o Machine.config raíz, el archivo de ensamblado debe estar en el directorio %SystemRoot%\Microsoft.NET\Framework\versión.

Elementos secundarios

Ninguno.

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 la sección de configuración y una sección de configuración.

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 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 ConfigurationSection que controla la sección o el elemento de configuración. Los elementos section se pueden agrupar lógicamente en elementos sectionGroup para organizarlos y para ayudar a 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 Framework 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>

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

<configuration>

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

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

</configuration>

Controlador de la sección de configuración

No procede.

Miembro de configuración

ConfigurationSection

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 1.0, 1.1 ó 2.0

Microsoft Visual Studio 2003 o Visual Studio 2005

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft