Elemento configuration (Esquema de configuración general)
Actualización: noviembre 2007
Es el elemento raíz necesario de cada archivo de configuración que utilizan las aplicaciones basadas en Common Language Runtime y .NET Framework.
<configuration xmlns="schema URL">
<!-- configuration settings -->
</configuration>
Atributos y elementos
En las siguientes secciones se describen los atributos, elementos secundarios y 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 la sección de configuración y las declaraciones de 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. |
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 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 procede. |
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 |
Servicios de Microsoft Internet Information Server (IIS) 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
Cómo: Tener acceso a las opciones de configuración de ASP.NET mediante programación
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
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)
Otros recursos
Opciones de configuración generales (ASP.NET)
Opciones de configuración de ASP.NET
Administrar sitios web ASP.NET