Elemento configuration (Esquema de configuración general)

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

Elemento raíz requerido de cada archivo de configuración utilizado por Common Language Runtime y las aplicaciones de .NET Framework.

<configuration xmlns="schema URL">
   <!-- configuration settings -->
</configuration>

Atributos y elementos

En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo

Descripción

xmlns

Atributo String opcional.

Especifica la dirección URL del esquema XML que se utiliza para validar el archivo de configuración. Si no se establece este atributo, no se podrá utilizar la Ayuda F1 en Microsoft Visual Studio para abrir los temas de los elementos de configuración.

El valor predeterminado para ASP.NET 2.0 es "http://schemas.microsoft.com/.NetConfiguration/v2.0".

Elementos secundarios

Elemento

Descripción

configSections

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

appSettings

Contiene la configuración de aplicación personalizada, como rutas de acceso de archivos, direcciones URL de servicios Web XML o cualquier información que se almacena en el archivo .ini de una aplicación.

connectionStrings

Especifica una colección de cadenas de conexión de bases de datos, como pares nombre/valor, para características y aplicaciones ASP.NET.

location

Especifica el recurso al que se aplican los valores de la configuración secundaria. Este elemento también bloquea los valores de configuración, con lo que se evita que los archivos de configuración secundarios los reemplacen.

Esquema de configuración de ASP.NET

Especifica todos los elementos que están en el esquema de configuración de ASP.NET.

Esquema de la configuración de inicio

Especifica todos los elementos que están en el esquema de configuración de inicio.

Esquema de la configuración de Common Language Runtime

Especifica todos los elementos que están en el esquema de configuración de Common Language Runtime.

Esquema de la configuración de la comunicación remota

Especifica todos los elementos que están en el esquema de configuración de comunicación remota.

Esquema de la configuración de red

Especifica todos los elementos que están en el esquema de configuración de red.

Esquema de la configuración de criptografía

Especifica todos los elementos que están en el esquema de configuración de criptografía.

Esquema de secciones de configuración

Especifica todos los elementos que están en el esquema de configuración de la sección de configuración.

Esquema de la configuración de traza y depuración

Especifica todos los elementos que están en el esquema de configuración de seguimiento y depuración.

Esquema de configuración de los servicios Web XML

Especifica todos los elementos que están en el esquema de configuración de servicios Web.

Elementos primarios

Ninguno.

Comentarios

El elemento configuration es el elemento raíz necesario en todos los archivos de configuración utilizados por las aplicaciones de Common Language Runtime y .NET Framework.

Cada archivo de configuración debe contener exactamente un elemento configuration.

Configuración predeterminada

En el ejemplo de código siguiente se muestra un archivo Web.config básico que se puede crear para cualquier aplicación de ASP.NET. La sección customErrors se proporciona por si fuese necesaria, pero está desactivada mediante un comentario.

<?xml version="1.0"?>
<configuration 
   xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">
    <appSettings/>
    <connectionStrings/>
    <system.web>
        <compilation debug="false"/>
        <authentication mode="Windows"/>
        <!--
        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
            <error statusCode="403" redirect="NoAccess.htm"/>
            <error statusCode="404" redirect="FileNotFound.htm"/>
        </customErrors>
        -->
    </system.web>
</configuration>

Información de elemento

Controlador de la sección de configuración

No se aplica.

Miembro de configuración

Configuration

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

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Accessing ASP.NET Configuration Settings

Referencia

Elemento configSections (Esquema de configuración general)

Elemento appSettings (Esquema de configuración general)

Elemento connectionStrings (Esquema de configuración de ASP.NET)

Elemento location (Esquema de configuración de ASP.NET)

Conceptos

ASP.NET Configuration Overview

Securing Configuration

Archivos de configuración

Format of ASP.NET Configuration Files

Configuration Inheritance

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration API