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

  • Artículo
  • Tiempo de lectura: 3 minutos

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

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

Resumen

El Web.config define el comportamiento de ASP.NET aplicaciones. Microsoft .NET Framework, incluido ASP.NET, usa archivos de texto con formato XML .config de texto para configurar aplicaciones. Esto es una salida de los mecanismos de configuración convencionales de registro y 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 .config archivos.

Agregar opciones de configuración a Web.config

La mayoría ASP.NET aplicaciones vienen con un archivo Web.config creado previamente que se puede editar con cualquier editor de texto, como Bloc de notas. Por lo general, Web.config archivos contienen comentarios que hacen que la edición del archivo se explica por sí mismo. Sin embargo, es posible que tenga que agregar elementos de configuración a un archivoWeb.config que aún no tenga definido el elemento de configuración. Para agregar un elemento de configuración estándar a unWeb.config , siga estos pasos:

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

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

  2. En el Machine.config , busque la configuración que desea invalidar en el Web.config archivo. 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 cerrarse a sí mismo 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 de las <!-- and --> marcas. El <trace> ejemplo del elemento de configuración siguiente es un ejemplo de un elemento de cierre automático. 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 elMachine.config archivo.

    El 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 al archivo Web.config , debe anidar ese elemento de configuración en el mismo elemento del que se copió. Para determinar el elemento del archivo Machine.config en el que está contenido el elemento de configuración, desplácese hacia arriba en el archivo Machine.config hasta que encuentre un elemento abierto, no cerrado. El elemento que lo contiene es fácil de identificar porque los elementos de nivel superior tienen menos sangría.

    La ASP.NET elementos de configuración están incluidos 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 Web.config archivo. Un elemento de configuración puede estar anidado en varios elementos. Debe crear todos los elementos de nivel superior en el Web.config archivo.

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

  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 <system.web> configuración está contenido en el elemento, <system.web> </system.web> el elemento de configuración debe pegarse inmediatamente después de la línea de apertura del elemento y antes de la línea de cierre.

  7. Modifique el elemento de configuración del archivoWeb.config para invalidar la Machine.config configuración de esa aplicación.

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

Referencias