Creación del archivo Web.config para una aplicación de ASP.NET

  • Artículo

En este artículo se describe cómo crear el archivo Web.config que se usa para controlar el comportamiento de las aplicaciones ASP.NET individuales.

              Versión original del producto: ASP.NET
Número de KB original: 815179

Resumen

Microsoft .NET Framework, y ASP.NET en particular, usa archivos de .config con formato XML para configurar aplicaciones. Esta práctica es una desviación de los mecanismos convencionales de configuración del registro y la metabase. Actualmente no hay ningún complemento de Microsoft Management Console (MMC) u otra herramienta de administración proporcionada por Microsoft que pueda usar para crear y modificar .config archivos.

Jerarquía de archivos .config

.NET Framework se basa en archivos .config para definir opciones de configuración. Los archivos .config son archivos XML basados en texto. Varios archivos .config pueden existir, y normalmente lo hacen, en un único sistema.

Los valores de configuración de todo el sistema para .NET Framework se definen en el archivo Machine.config . El archivo Machine.config se encuentra en la %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ carpeta . La configuración predeterminada contenida en el archivo Machine.config se puede modificar para afectar al comportamiento de las aplicaciones .NET de Microsoft en todo el sistema.

Puede cambiar los valores de configuración de ASP.NET para una sola aplicación si crea un archivo Web.config en la carpeta raíz de la aplicación. Al hacerlo, la configuración del archivo Web.config invalida la configuración del archivo Machine.config .

Creación de un archivo Web.config

Puede crear un archivo Web.config mediante un editor de texto como el Bloc de notas. Debe crear un archivo de texto denominado Web.config en el directorio raíz de la aplicación de ASP.NET. El archivo Web.config debe ser un documento XML bien formado y debe tener un formato similar al %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\Machine.config archivo.

El archivo Web.config solo debe contener entradas para los elementos de configuración que invalidan la configuración en el archivo Machine.config . Como mínimo, el archivo Web.config debe tener el <configuration> elemento y el <system.web> elemento . Estos elementos contendrán elementos de configuración individuales.

En el ejemplo siguiente se muestra un archivo deWeb.config mínimo:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.web>
    </system.web>
</configuration>

La primera línea del archivo Web.config describe el documento como con formato XML y especifica el tipo de codificación de caracteres. Esta primera línea debe ser la misma para todos los archivos .config.

Las líneas siguientes marcan el principio y el final del <configuration> elemento y el <system.web> elemento del archivo Web.config . Por sí solas, estas líneas no hacen nada. Sin embargo, las líneas proporcionan una estructura que le permite agregar opciones de configuración futuras. Agregue la mayoría de los valores de configuración de ASP.NET entre las <system.web> líneas y </system.web> . Estas líneas marcan el principio y el final de la configuración de ASP.NET.

Referencias