Cómo: Crear archivos Web.config

Artículo
10/22/2014

Actualización: noviembre 2007

ASP.NET utiliza una jerarquía de archivos de texto XML, todos denominados Web.config, para almacenar valores que controlan cómo funciona su sitio Web. Con las características del sistema de configuración de ASP.NET, puede configurar todo un servidor, una aplicación ASP.NET o páginas individuales. Este tema describe cómo crear un archivo Web.config en Visual Web Developer.

Para crear un archivo Web.config

En el Explorador de soluciones, haga clic en el icono Actualizar para asegurarse de que no existe ningún archivo Web.config para su aplicación.

Si ya ha utilizado la herramienta Administración de sitios Web o alguna otra manera de configurar su aplicación, es posible que se haya creado un archivo Web.config automáticamente. Haga clic en Actualizar para actualizar la lista de archivos.
En el Explorador de soluciones, haga clic con el botón secundario del mouse en el nombre del sitio Web y haga clic en Agregar nuevo elemento.
En la ventana Plantillas, haga clic en Archivo de configuración Web.

El nombre de archivo en el cuadro de texto Nombre debe ser Web.config. Este es el nombre predeterminado del archivo aunque le puede dar otro nombre. La extensión de nombre de archivo .config está protegida para que ASP.NET no la pueda descargar.
Haga clic en Agregar para crear el archivo y abrirlo para editarlo.

El archivo contiene el código que se muestra en la sección "Ejemplo" más adelante en este tema, con unos cuantos valores predeterminados iniciales. La aplicación hereda todos los valores de configuración de los archivos Machine.config y Web.config en el directorio %SystemRoot%\Microsoft.NET\Framework\<versión>\CONFIG, pero no verá dichos valores predeterminados aquí. Solo necesita crear archivos Web.config en el nivel de aplicación o de directorio si desea reemplazar los valores predeterminados heredados o agregar a los elementos de la colección como Elemento httpHandlers (Esquema de configuración de ASP.NET).

Para ver todos los valores de configuración para la aplicación actual, podría ejecutar el código incluido en el tema Cómo: Ver los valores de configuración heredados y locales mediante programación. Otra alternativa consiste en ver los archivos Machine.config.comments o Web.config.comments (que además contienen comentarios útiles) en el directorio %SystemRoot%\Microsoft.NET\Framework\<versión>\CONFIG, pero estos dos archivos no contendrán todos los valores en tiempo de ejecuciónCómo: Ver los valores de configuración heredados y locales mediante programación.
Si cambia el archivo Web.config, guárdelo.

Al guardar un archivo Web.config se reinicia la aplicación. Como alternativa, puede utilizar el atributo configSource de elementos de sección individual para indicar un archivo de configuración secundario que no obligue a la aplicación a reiniciarse al cambiarla. Para obtener más información, vea configSource en Atributos generales heredados por elementos de una sección.

Para utilizar IntelliSense para editar los valores de configuración

En Visual Web Developer, abra el archivo Web.config.
En la ventana de edición, sitúe el cursor dentro de las fichas <system.web> </system.web> en una línea por sí mismo, pero no dentro de ninguna etiqueta.
Escriba el carácter menor que (<) para iniciar un elemento nuevo.

Aparece una lista desplegable que ofrece elementos válidos para agregarlos en este punto de inserción. También, puede presionar Ctrl+J para mostrar la lista desplegable sin tener que escribir el carácter menor que.
Seleccione anonymousIdentification.

El elemento Elemento anonymousIdentification (Esquema de configuración de ASP.NET) se sitúa en el archivo Web.config y termina. Si un elemento termina con una etiqueta de cierre, esto quiere decir que existen elementos secundarios que puede configurar. Si un elemento termina, como el siguiente elemento anonymousIdentification, no existen elementos secundarios que configurar.
```
<anonymousIdentification />
```
Sitúe el cursor dentro de la etiqueta <anonymousIdentification /> y presione la BARRA ESPACIADORA.

Aparece una lista desplegable que ofrece atributos válidos para agregarlos al elemento anonymousIdentification. También, puede presionar Ctrl+J para mostrar la lista desplegable sin tener que presionar la BARRA ESPACIADORA.
Seleccione habilitado.

El atributo enabled se guarda en el archivo Web.config y al ser un atributo booleano, los valores de true y false están disponibles en la lista desplegable.
Seleccione false. Éste es el valor predeterminado.

El sistema IntelliSense realiza sugerencias para los elementos y atributos que están disponibles en el punto de inserción. Algunas veces, los atributos especializados no se ofrecen. Por ejemplo, cuando se configura un elemento providers, como por ejemplo para el elemento Elemento siteMap (Esquema de configuración de ASP.NET), varios atributos diferentes están disponibles dependiendo del tipo de proveedor que se está agregando. IntelliSense no muestra estos atributos porque dependen del valor del atributo type.
Cambie el valor del atributo enabled a "falsex", que no es un valor válido.

El sistema IntelliSense proporciona la comprobación de validación y muestra una línea ondulante por debajo del texto que no valide.

Ejemplo

El siguiente ejemplo de código muestra el contenido inicial de un archivo Web.config creado por Visual Web Developer. Se proporcionan valores predeterminados para los elementos de compilación y autenticación. Para habilitar la depuración ASP.NET, sólo hay que cambiar el atributo debug del elemento compilation en true. Todos los elementos que pueden aparecer dentro del elemento system.web están documentados en Opciones de configuración de ASP.NET.

<?xml version="1.0"?>
<!-- 
    Note: As an alternative to hand editing this file you can use the 
    Web Site Administration Tool to configure settings for your application. Use
    the Web site->Asp.Net Configuration option in Visual Studio.
    A full list of settings and comments can be found in 
    machine.config.comments usually located in 
    \Windows\Microsoft.Net\Framework\v2.x\Config 
-->
<configuration xmlns="https://schemas.microsoft.com/.NetConfiguration/v2.0">
    <appSettings/>
    <connectionStrings/>
    <system.web>
        <!-- 
            Set compilation debug="true" to insert debugging 
            symbols into the compiled page. Because this 
            affects performance, set this value to true only 
            during development.
        -->
        <compilation debug="false"/>
        <!--
            The <authentication> section enables configuration 
            of the security authentication mode used by 
            ASP.NET to identify an incoming user. 
        -->
        <authentication mode="Windows"/>
        <!--
            The <customErrors> section enables configuration 
            of what to do if/when an unhandled error occurs 
            during the execution of a request. Specifically, 
            it enables developers to configure html error pages 
            to be displayed in place of a error stack trace.

        <customErrors mode="RemoteOnly" defaultRedirect="GenericErrorPage.htm">
            <error statusCode="403" redirect="NoAccess.htm"/>
            <error statusCode="404" redirect="FileNotFound.htm"/>
        </customErrors>
        -->
    </system.web>
</configuration>

Seguridad

Cuando almacene información confidencial en un archivo de configuración de una aplicación, debe cifrar los valores confidenciales mediante la configuración protegida. Para obtener más información sobre este y otros temas de seguridad para archivos de configuración, vea Proteger la configuración de ASP.NET.