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 "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 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. |
Especifica todos los elementos que están en el esquema de configuración de ASP.NET. |
|
Especifica todos los elementos que están en el esquema de configuración de inicio. |
|
Especifica todos los elementos que están en el esquema de configuración de Common Language Runtime. |
|
Especifica todos los elementos que están en el esquema de configuración de comunicación remota. |
|
Especifica todos los elementos que están en el esquema de configuración de red. |
|
Especifica todos los elementos que están en el esquema de configuración de criptografía. |
|
Especifica todos los elementos que están en el esquema de configuración de la sección de configuración. |
|
Especifica todos los elementos que están en el esquema de configuración de seguimiento y depuración. |
|
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 se aplica. |
Miembro de configuración |
|
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
Format of ASP.NET Configuration Files
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET