Compartir a través de

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

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

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

Resumen

Microsoft .NET Framework y ASP.NET, en particular, usa archivos .config con formato XML para configurar aplicaciones. Esta práctica es una salida de los mecanismos convencionales de configuración de registro y 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 archivos .config.

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. Pueden existir varios archivos .config y, normalmente, 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 de Microsoft .NET 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 en el 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 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 Web.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 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í mismos, 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 los valores de configuración de ASP.NET.

Referencias