Compartir a través de

Edición de la configuración de una aplicación de ASP.NET

En este artículo se describe cómo editar el archivo Web.config de una aplicación de ASP.NET.

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

Resumen

El archivo Web.config define el comportamiento de ASP.NET aplicaciones. Microsoft .NET Framework, incluido ASP.NET, usa archivos de texto .config con formato XML para configurar aplicaciones. Se trata de una salida de los mecanismos convencionales de configuración de registro y metabase. Actualmente no hay ningún complemento de Microsoft Management Console (MMC) ni otra herramienta de administración proporcionada por Microsoft para crear y modificar archivos .config.

Adición de opciones de configuración a Web.config

La mayoría de las aplicaciones ASP.NET vienen con un archivo Web.config precompilado que se puede editar con cualquier editor de texto, como el Bloc de notas. Por lo general, los archivos Web.config contienen comentarios que hacen que la edición del archivo se explique automáticamente. Sin embargo, es posible que tenga que agregar elementos de configuración a un archivo Web.config que aún no tiene definido el elemento de configuración. Para agregar un elemento de configuración estándar a un archivo Web.config , siga estos pasos:

  1. Abra el archivo Machine.config en un editor de texto como el Bloc de notas.

    El archivo Machine.config se encuentra en el %SystemRoot%\Microsoft.NET\Framework\%VersionNumber%\CONFIG\ directorio .

  2. En el archivo Machine.config , busque la configuración que desea invalidar en el archivo Web.config . Cuando el elemento es más de una línea, el elemento comienza con una <element_name> línea y termina con </element_name>. El elemento también puede ser de cierre propio y puede tener un aspecto similar a <element_name attribute1='option' attribute2='option' />. Se omite el espacio en blanco. Por lo tanto, el elemento puede abarcar varias líneas. El elemento puede ir precedido de un comentario. El comentario se encuentra dentro <!-- and --> de las marcas. El <trace> ejemplo de elemento de configuración siguiente es un ejemplo de un elemento de autocierre. El <trace> ejemplo del elemento de configuración tiene varios atributos, abarca varias líneas y tiene un comentario al principio.

    <!--
trace Attributes:
    enabled="[true|false]" - Enable application tracing
    localOnly="[true|false]" - View trace results from localhost only
    pageOutput="[true|false]" - Display trace output on individual pages
    requestLimit="[number]" - Number of trace results available in trace.axd
    traceMode="[SortByTime|SortByCategory]" - Sorts trace result displays based on Time or Category
 -->
<trace
    enabled="false"
    localOnly="true"
    pageOutput="false"
    requestLimit="10"
    traceMode="SortByTime"
/>

  3. Copie todo el elemento de configuración y cualquier comentario inicial en el Portapapeles.

  4. Determine cómo se anida el elemento en el archivo Machine.config .

    El archivo Machine.config es jerárquico y los elementos de configuración están anidados en otros elementos. Al copiar un elemento de configuración del archivo Machine.config en el archivo Web.config , debe anidar ese elemento de configuración en el mismo elemento desde el que se copió. Para determinar el elemento del archivo Machine.config en el que se encuentra el elemento de configuración, desplácese hacia arriba en el archivo Machine.config hasta que encuentre un elemento abierto, no cerrado. El elemento contenedor es sencillo de identificar porque los elementos de nivel superior tienen menos sangría.

    La mayoría de los elementos de configuración ASP.NET se encuentran en el <system.web> elemento . El final del elemento ( </system.web> ) debe colocarse después del elemento de configuración.

    Nota:

    Elemento en el que se encuentra el elemento de configuración. Debe pegar ese elemento en el mismo elemento del archivo Web.config . Un elemento de configuración se puede anidar en varios elementos. Debe crear todos los elementos de nivel superior en el archivo Web.config .

  5. Cierre el archivo Machine.config y, a continuación, use el editor de texto para abrir el archivo Web.config en el directorio raíz de la aplicación ASP.NET.

  6. Pegue el elemento de configuración entre el principio y el final del elemento que identificó en el paso 4.

    Por ejemplo, si el elemento de configuración está incluido en el <system.web> elemento , el elemento de configuración debe pegarse inmediatamente después de la línea de apertura del <system.web> elemento y antes de la línea de </system.web> cierre.

  7. Modifique el elemento de configuración en el archivo Web.config para invalidar el valor Machine.config de esa aplicación.

    Esta configuración se aplica a la carpeta que contiene el archivo Web.config y todas las subcarpetas.

Referencias