Inicio rápido: Depuración de ASP.NET Core con el depurador de Visual Studio

En este inicio rápido, explorará cómo usar el depurador de Visual Studio para depurar el código de la aplicación ASP.NET Core. En este artículo se proporciona una manera rápida de aprender algunas de las características básicas para trabajar en el depurador.

Si no tiene Visual Studio, puede instalar la versión de prueba gratuita desde la página descargas de Visual Studio.

Creación de un nuevo proyecto

Empiece por crear un nuevo proyecto, para tener algo de código que comprobar en el depurador.

1. Abra Visual Studio y cree un proyecto.

   • Si la ventana de inicio no está abierta, seleccione Archivo>Ventana de inicio.

   • En la ventana Inicio, seleccione Crear un nuevo proyecto.

2. En la ventana Crear un nuevo proyecto , establezca los filtros y busque una plantilla de proyecto.

   • En el cuadro Buscar plantillas , escriba aplicación web.

   • Expanda la lista desplegable Lenguaje y seleccione C#.

3. En la lista de resultados, seleccione la plantilla ASP.NET Core Web App (Razor Pages) para C#y, a continuación, seleccione Next.

   Si no ve la plantilla ASP.NET Core Web App (Razor Pages) para C#, seleccione la opción Continue sin código.

   1. Seleccione Tools>Obtener herramientas y características... , que abre el instalador de Visual Studio.

   2. En la ventana del instalador, active la casilla correspondiente a la carga de trabajo ASP.NET y desarrollo web y, a continuación, seleccione Modificar.

      La instalación de Visual Studio se actualiza para incluir la carga de trabajo de ASP.NET seleccionada.

   3. Una vez completada la actualización, seleccione Archivo>Ventana de inicio y siga las instrucciones anteriores para seleccionar la plantilla requerida.

4. Configure el nuevo proyecto:

   1. Escriba un nombre Project y Nombre de solución o use los valores predeterminados.

   2. Use la ubicación predeterminada o seleccione Examinar (...) para crear el proyecto en otra carpeta.

   3. Seleccione Siguiente.

   4. Use el Framework de destino recomendado (el valor predeterminado es .NET 10.0 Soporte a largo plazo).

   5. Para la otra configuración, use los valores predeterminados.

   6. Selecciona Crear.

   Visual Studio crea el nuevo proyecto y agrega los archivos del proyecto en la carpeta especificada.

Actualización del código del proyecto

Actualice parte del código proporcionado por la plantilla de proyecto para que tenga más instrucciones para probar en el depurador.

1. En el panel Explorador de soluciones, expanda el nodo <project-name>\Pages y seleccione el elemento Privacy.cshtml.

   El archivo Privacy.cshtml se abre en el editor de código.

2. Busque la siguiente sección de código en el archivo y reemplácela por el fragmento de código proporcionado:

   @{
    ViewData["Title"] = "Privacy Policy";
   }
   

   Fragmento de código de reemplazo:

   @{
    ViewData["Title"] = "Privacy Policy";
    <label>@PrivacyModel.PrivacyMessage</label>
   }
   

3. En Explorador de soluciones, expanda el nodo <project-name>\Pages\Privacy.cshtml y seleccione el elemento Privacy.cshtml.cs.

   El archivo Privacy.cshtml.cs se abre en el editor de código.

4. Busque la siguiente sección de código en el archivo y reemplácela por el fragmento de código proporcionado:

   public void OnGet()
   {
   }
   

   Fragmento de código de reemplazo:

   
   public static string? PrivacyMessage { get; set; }
   
   public void OnGet() {
      LinkedList<int> result = DoWork();
   
      PrivacyMessage = "Result of work: " + result.First.Value + ", " + result.First.Value;
   }
   
   private static LinkedList<int> DoWork() {
      LinkedList<int> c1 = new();
   
      c1.AddLast(10);
      c1.AddLast(20);
   
      LinkedList<int> c2 = new(c1);
      return c2;
   }
   

Establecer un punto de interrupción

Un breakpoint es un marcador que indica dónde Visual Studio debe suspender el código en ejecución. Cuando se establece un punto de interrupción, puede echar un vistazo a los valores actuales de las variables, examinar el comportamiento de la memoria y comprobar si se está ejecutando una rama de código específica. Los puntos de interrupción son la función más básica de la depuración.

1. Para establecer un punto de interrupción, busque la llamada a la DoWork función en el código y, a continuación, seleccione en el margen izquierdo de la misma línea.

   Cuando se establece el punto de interrupción, se muestra un punto rojo en el margen izquierdo de la línea correspondiente del código.

   

2. Inicie la depuración mediante el método abreviado de teclado F5 (o seleccione Depurar>).

3. Cuando se abra la página web en la ventana del explorador, seleccione el vínculo Privacidad en la parte superior de la página.

   La ejecución del código se detiene inmediatamente antes de la llamada a la DoWork función.

   El depurador se detiene donde se ha establecido el punto de interrupción. Una flecha amarilla indica la instrucción en la que el depurador detiene la ejecución de la aplicación.

   

Establecimiento de puntos de interrupción condicionales

Si establece un punto de interrupción en un bucle o recursividad, o si tiene muchos puntos de interrupción que recorre con frecuencia, use un punto de interrupción condicional.

Este enfoque ayuda a garantizar que el código se suspenda solo cuando se cumplen condiciones específicas. Un punto de interrupción condicional puede ahorrar tiempo y también facilitar la depuración de problemas que son difíciles de reproducir.

Recorre tu código paso a paso

Visual Studio proporciona varias maneras diferentes de indicar al depurador que continúe con la ejecución de la aplicación. En el ejemplo siguiente se muestra un comando útil para recorrer el código.

Mientras el código está en pausa en el punto de interrupción, mantenga el puntero sobre la instrucción return c2; hasta que vea el icono verde Ejecutar para hacer clic (Ejecutar hasta aquí). Seleccione el icono.

La aplicación sigue ejecutándose y se pausa en la línea de código donde hizo clic en el botón.

Los comandos de teclado comunes que se usan para recorrer el código incluyen F10 y F11. Para obtener instrucciones más detalladas, consulte Primer vistazo al depurador.

Inspección de variables en una sugerencia de datos

Puede inspeccionar el estado de las variables con la función sugerencia de datos.

1. En la línea de código actual (marcada por el puntero de ejecución amarillo), mantenga el puntero sobre el c2 objeto para ver la sugerencia de datos.

   

   La sugerencia de datos muestra el valor actual de la c2 variable y le permite inspeccionar sus propiedades.

   Al depurar, si ve un valor inesperado para una variable, es probable que tenga un error. El error podría estar en el código que realiza la llamada a la variable o en la línea anterior.

2. Expanda la sugerencia de datos para ver los valores de propiedad actuales del c2 objeto.

3. Para continuar comprobando el valor de c2 a medida que se ejecuta el código, seleccione el icono de anclaje en la sugerencia de datos.

   La acción de anclaje mantiene abierta la sugerencia de datos. A medida que se ejecuta el código, el valor de la sugerencia anclada cambia para mostrar el estado actual del objeto observado.

   Puede mover la indicación fijada a cualquier lugar del IDE para que no le impida consultar otros elementos durante la depuración.

Paso siguiente

Información general del depurador de Visual Studio