Compartir a través de


Cómo: Habilitar la depuración de aplicaciones de ASP.NET

Actualización: noviembre 2007

Este tema se aplica a:

Edición

Visual Basic

C#

C++

Web Developer

Express

Standard

Pro y Team

Leyenda de la tabla:

Se aplica

No procede

Comando o comandos Cómo: Restaurar los comandos ocultos del depurador.

Para habilitar la depuración, debe habilitarla en la página Propiedades del proyecto y en el archivo de configuración web.config de la aplicación.

Nota:

Los cuadros de diálogo y comandos de menú que se ven pueden diferir de los descritos en la Ayuda, en función de los valores de configuración o de edición activos. Para cambiar la configuración, elija la opción Importar y exportar configuraciones del menú Herramientas. Para obtener más información, vea Valores de configuración de Visual Studio.

Para habilitar la depuración ASP.NET en las propiedades del proyecto (Visual Basic/C #)

  1. En el Explorador de soluciones, haga clic con el botón secundario del mouse en el nombre de un proyecto web y seleccione Páginas de propiedades.

    Aparecerán las Páginas de propiedades de <proyecto>.

  2. Haga clic en la ficha Web.

  3. En Depuradores, active la casilla ASP.NET.

Para habilitar la depuración en el archivo web.config

  1. Abra el archivo web.config utilizando cualquier editor de texto estándar o un analizador XML.

    1. Sin embargo, no se puede tener acceso al archivo en modo remoto utilizando un explorador web. Por motivos de seguridad, ASP.NET configura Microsoft IIS para impedir el acceso directo del explorador a los archivos Web.config. Si intenta obtener acceso a un archivo de configuración utilizando un explorador, obtendrá el error de acceso 403 de HTTP (prohibido).
  2. Web.config es un archivo XML, por lo que contiene secciones anidadas marcadas por etiquetas. El siguiente ejemplo muestra un archivo Web.config típico. Modifique el archivo siguiendo estos pasos:

    1. Busque la etiqueta <compilation>. Esta etiqueta marca el comienzo de la sección <compilation>.

    2. En la etiqueta <compilation>, creerá el atributo de depuración. En el ejemplo siguiente, debug es el segundo atributo especificado en la etiqueta <compilation>, pero el orden no tiene importancia.

    3. Los atributos distinguen entre mayúsculas y minúsculas, por consiguiente, asegúrese de que especifica "debug", y no "Debug" ni "DEBUG".

    4. Establezca debug en true, como se muestra en el ejemplo de código siguiente.

  3. Si no establece el atributo de depuración en true e intenta iniciar una sesión de depuración, aparecerá un cuadro de diálogo que le ofrecerá crear un archivo web.config conteniendo el atributo de depuración establecido. Acepte y continúe para depurar.

Ejemplo

<configuration>
    <system.web>
        <compilation defaultLanguage="VB"
            debug="true"
            numRecompilesBeforeAppRestart="15">
            <compilers>
            <compiler language="VB;VBScript"
            extension=".cls"
            type="Microsoft.VisualBasic.VBCodeProvider,system, Version=1.0.5000.0,
Culture=neutral, PublicKeyToken=b77a5c561934e089" />
            < compiler language="C#;Csharp"
                extension=".cs" 
                type="Microsoft.CSharp.CSharpCodeProvider,system, Version=1.0.5000.0,  Culture=neutral, PublicKeyToken=b77a5c561934e089" />
        </compilers>

        <assemblies>
""            <add assembly="ADODB" />
            <add assembly="*" />
            </assemblies>

            <namespaces>
            <add namespace="System.Web" />
            <add namespace="System.Web.UI" />
            <add namespace="System.Web.UI.WebControls" />
            <add namespace="System.Web.UI.HtmlControls" />
        </namespaces>

        </compilation>
    </system.web>
</configuration>

Programación eficaz

ASP.NET detecta automáticamente los cambios realizados en los archivos Web.config y aplica la nueva configuración. No es preciso reiniciar el equipo ni el servidor IIS para que los cambios surtan efecto.

Un sitio web puede contener varios directorios y subdirectorios virtuales que incluyan archivos Web.config. Las aplicaciones ASP.NET heredan la configuración de los archivos Web.config que se encuentran en los niveles más altos en la ruta de acceso de la dirección URL. Los archivos de configuración jerárquicos permiten cambiar la configuración de varias aplicaciones ASP.NET simultáneamente, por ejemplo de todas las aplicaciones que se encuentren por debajo en la jerarquía. Sin embargo, si se establece el atributo debug en un archivo inferior en la jerarquía, reemplazará el valor más alto.

De este modo, puede especificar debug="true" en www.microsoft.com/aaa/Web.config y todas las aplicaciones de la carpeta aaa y todas las subcarpetas de aaa heredarán esa configuración. Por tanto, si la aplicación ASP.NET está en www.microsoft.com/aaa/bbb, heredará dicha configuración, al igual que cualquier aplicación ASP.NET en www.microsoft.com/aaa/ccc, www.microsoft.com/aaa/ddd, etc. La única excepción es si una de esas aplicaciones reemplaza la configuración por medio de su propio archivo Web.config inferior.

Si se habilita el modo de depuración, afectará enormemente al rendimiento de la aplicación ASP.NET. No olvide deshabilitar el modo de depuración antes de implementar la aplicación o realizar controles de rendimiento.

Vea también

Otros recursos

Depurar aplicaciones ASP.NET y aplicaciones habilitadas para AJAX