Compartir a través de


Elemento configuration (Esquema de configuración general)

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 secciones siguientes 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 "https://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 configuración de aplicación personalizada, como rutas de acceso a archivos, direcciones URL de servicios Web XML o cualquier información almacenada en el archivo .ini de una aplicación.

connectionStrings

Especifica una colección de cadenas de conexión a bases de datos (en forma de pares de nombre y valor) para las aplicaciones y características de 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 seguimiento 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="https://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 procede.

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

Microsoft Visual Studio 2003 o Visual Studio 2005

Vea también

Tareas

Cómo: Tener acceso a las opciones de configuración de ASP.NET mediante programación

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

Información general sobre la configuración de ASP.NET

Proteger la configuración de ASP.NET

Editar los archivos de configuración de ASP.NET

Escenarios de configuración de ASP.NET

Otros recursos

Opciones de configuración generales (ASP.NET)

Opciones de configuración de ASP.NET

Administración de sitios web ASP.NET

API de configuración de ASP.NET

Archivos de configuración