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

  • Artículo

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

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

Resumen

El archivo Web.config define el comportamiento de las aplicaciones ASP.NET. Microsoft .NET Framework, incluidos los 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 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 para crear y modificar archivos .config.

Agregar opciones de configuración a Web.config

La mayoría de las aplicaciones ASP.NET incluyen un archivo Web.config precompilado que se puede editar con cualquier editor de texto, como el Bloc de notas. Por lo general, Web.config archivos 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 deWeb.config que aún no tenga 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 autocierre y puede ser similar a <element_name attribute1='option' attribute2='option' />. Los espacios en blanco no se tienen en cuenta. Por lo tanto, el elemento puede abarcar varias líneas. El elemento puede ir precedido de un comentario. El comentario está contenido dentro <!-- and --> de marcas. El <trace> ejemplo de elemento de configuración siguiente es un ejemplo de un elemento de cierre automático. El <trace> ejemplo de 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 del que se copió. Para determinar el elemento del archivo deMachine.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 fácil de identificar porque los elementos de nivel superior tienen menos sangría.

    La mayoría ASP.NET elementos de configuración 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 puede anidarse 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 de 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 del archivo Web.config para invalidar la configuración deMachine.config para esa aplicación.

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

Referencias