Tutorial: Información sobre cómo depurar código de Visual Basic con Visual Studio

Si todavía no ha instalado Visual Studio, vaya a la página de descargas de Visual Studio para instalarlo de forma gratuita.

Si tiene que instalar la carga de trabajo pero ya tiene Visual Studio, vaya a Herramientas>Obtener herramientas y características… y se abrirá el Instalador de Visual Studio. Se iniciará el Instalador de Visual Studio. Elija la carga de trabajo Desarrollo multiplataforma de .NET Core y, después, Modificar.

Si todavía no ha instalado Visual Studio, vaya a la página de descargas de Visual Studio para instalarlo de forma gratuita.

Si tiene que instalar la carga de trabajo pero ya tiene Visual Studio, vaya a Herramientas>Obtener herramientas y características… y se abrirá el Instalador de Visual Studio. Se iniciará el Instalador de Visual Studio. Elija la carga de trabajo Desarrollo de escritorio de .NET y, luego, seleccione Modificar.

3. En el cuadro de búsqueda de la ventana Crear un proyecto, escriba consola. Seguidamente, elija Visual Basic en la lista de lenguajes y luego, Windows en la lista de plataformas.

   Después de aplicar los filtros de lenguaje y plataforma, elija la plantilla Aplicación de consola para .NET Core y luego seleccione Siguiente.

   

   Nota:

   Si no ve la plantilla Aplicación de consola, puede instalarla desde la ventana Crear un proyecto. En el mensaje ¿No encuentra lo que busca? , elija el vínculo Instalar más herramientas y características. Luego, en el Instalador de Visual Studio, elija la carga de trabajo Desarrollo multiplataforma de .NET Core.

4. En la ventana Configurar el nuevo proyecto, escriba get-started-debugging en el cuadro Nombre del proyecto. Después, seleccione Siguiente.

5. Seleccione la plataforma de destino recomendada (compatibilidad con .NET 8.0 o a largo plazo) y, a continuación, seleccione Crear.

3. En el cuadro de búsqueda de la ventana Crear un proyecto, escriba consola. Seguidamente, elija Visual Basic en la lista de lenguajes y luego, Windows en la lista de plataformas.

   Después de aplicar los filtros de lenguaje y plataforma, elija la plantilla Aplicación de consola para .NET Core y luego seleccione Siguiente.

   

   Nota:

   Si no ve la plantilla Aplicación de consola, puede instalarla desde la ventana Crear un proyecto. En el mensaje ¿No encuentra lo que busca? , elija el vínculo Instalar más herramientas y características. A continuación, en el Instalador de Visual Studio, elija la carga de trabajo Desarrollo de escritorio de .NET.

4. En la ventana Configurar el nuevo proyecto, escriba get-started-debugging en el cuadro Nombre del proyecto. Después, seleccione Siguiente.

5. En la ventana Información adicional, asegúrese de que esté seleccionado .NET 8.0 en el menú desplegable Marco y, luego, seleccione Crear.

1. Presione F5 (Depurar > Iniciar depuración) o el botón Iniciar depuración en la barra de herramientas de depuración.

   Al pulsar F5, la aplicación se inicia con el depurador activado para analizar los procesos. Como de momento no hemos hecho nada especial para examinar el código, la aplicación solo se carga y se muestra la salida de la consola.

   Hello, f! Count to 1
   Hello, fr! Count to 2
   Hello, fre! Count to 3
   Hello, fred! Count to 4
   Hello, fred ! Count to 5
   Hello, fred s! Count to 6
   Hello, fred sm! Count to 7
   Hello, fred smi! Count to 8
   Hello, fred smit! Count to 9
   Hello, fred smith! Count to 10
   

   En este tutorial, analizará con más profundidad el uso de esta aplicación junto con el depurador y verá las características del depurador.

2. Detenga el depurador; para ello, presione el botón de detención rojo (Shift + F5).

3. En la ventana de consola, presione una tecla para cerrarla.

1. Presione F5 (Depurar > Iniciar depuración ) o seleccione el botón verde Iniciar depuración en la barra de herramientas de depuración.

   

   Al pulsar F5, la aplicación se inicia con el depurador activado para analizar los procesos. Como de momento no hemos hecho nada especial para examinar el código, la aplicación solo se carga y se muestra la salida de la consola.

   Hello, f! Count to 1
   Hello, fr! Count to 2
   Hello, fre! Count to 3
   Hello, fred! Count to 4
   Hello, fred ! Count to 5
   Hello, fred s! Count to 6
   Hello, fred sm! Count to 7
   Hello, fred smi! Count to 8
   Hello, fred smit! Count to 9
   Hello, fred smith! Count to 10
   

   En este tutorial, analizará con más profundidad el uso de esta aplicación junto con el depurador y verá las características del depurador.

2. Detenga el depurador; para ello, presione (Mayús + F5) o seleccione el botón rojo Detener depuración en la barra de herramientas de depuración.

   

3. En la ventana de consola, presione una tecla para cerrarla.

1. En el bucle For de la función Main, establezca un punto de interrupción haciendo clic en el margen izquierdo de la siguiente línea de código:

   name += letters(i)

   En el lugar en el que establezca el punto de interrupción aparecerá un círculo rojo .

   Los puntos de interrupción son una de las características más básicas y esenciales de una depuración confiable. Un punto de interrupción indica dónde Visual Studio debe suspender la ejecución de código para poder echar un vistazo a los valores de las variables o al comportamiento de la memoria, o determinar si se está ejecutando o no una bifurcación de código.

2. Presione F5 o el botón Iniciar depuración. La aplicación se inicia y el depurador se ejecuta hasta la línea de código en la que haya establecido el punto de interrupción.

   

   La flecha amarilla representa la instrucción en la que el depurador se ha pausado. La ejecución del código se suspende en el mismo punto (esta instrucción aún no se ha ejecutado).

   Si la aplicación todavía no se está ejecutando, F5 inicia el depurador y lo detiene en el primer punto de interrupción. En caso contrario, F5 permite continuar ejecutando la aplicación hasta el siguiente punto de interrupción.

   Los puntos de interrupción son una característica de utilidad cuando se conoce la línea o la sección de código que se quiere examinar en detalle. Para obtener información sobre los diferentes tipos de puntos de interrupción que se pueden establecer, como los puntos de interrupción condicionales, vea Uso de puntos de interrupción.

1. En el bucle For de la función Main, establezca un punto de interrupción haciendo clic en el margen izquierdo de la siguiente línea de código:

   name += letters(i)

   En el lugar en el que establezca el punto de interrupción aparecerá un círculo rojo .

   Los puntos de interrupción son una de las características más básicas y esenciales de una depuración confiable. Un punto de interrupción indica dónde Visual Studio debe suspender la ejecución de código para poder echar un vistazo a los valores de las variables o al comportamiento de la memoria, o determinar si se está ejecutando o no una bifurcación de código.

2. Presione F5 (Depurar > Iniciar depuración) o el botón Iniciar depuración en la barra de herramientas de depuración. La aplicación se inicia y el depurador se ejecuta en la línea de código en la que ha establecido el punto de interrupción.

   

   La flecha amarilla representa la instrucción en la que el depurador se ha detenido, lo cual también suspende la ejecución de la aplicación en el mismo punto (esta instrucción todavía no se ha ejecutado).

   Si la aplicación todavía no se está ejecutando, F5 inicia el depurador y lo detiene en el primer punto de interrupción. En caso contrario, F5 permite continuar ejecutando la aplicación hasta el siguiente punto de interrupción.

   Los puntos de interrupción son una característica de utilidad cuando se conoce la línea o la sección de código que se quiere examinar en detalle. Para obtener información sobre los diferentes tipos de puntos de interrupción que se pueden establecer, como los puntos de interrupción condicionales, vea Uso de puntos de interrupción.

Normalmente, aquí usamos métodos abreviados de teclado porque son una buena forma de ejecutar rápidamente la aplicación en el depurador, pero los comandos equivalentes, como los comandos de menú, se muestran entre paréntesis.

1. Mientras la ejecución del código está en pausa en el bucle For del método Main, presione F11 dos veces (o bien elija Depurar > Depurar paso a paso por instrucciones) para avanzar a la llamada al método SendMessage.

   Después de presionar F11 dos veces, debería estar en esta línea de código:

   SendMessage(name, a(i))

2. Presione F11 una vez más para entrar en el método SendMessage.

   El puntero de color amarillo avanza hasta el método SendMessage.

   

   F11 es el comando Depurar paso a paso por instrucciones y permite avanzar la ejecución de la aplicación de instrucción en instrucción. F11 es una buena forma de examinar el flujo de ejecución con más detalle. Más adelante le mostraremos otras opciones para moverse más rápido por el código. De forma predeterminada, el depurador omite el código que no es de usuario (si quiere más detalles, vea Solo mi código).

   Imagine que ha terminado de examinar el método SendMessage y quiere salir de él, pero permanecer en el depurador. Puede hacerlo con el comando Salir de la depuración.

3. Presione Mayús + F11 (o Depurar > Salir de la depuración).

   Este comando reanuda la ejecución de la aplicación (y hace avanzar el depurador) hasta que se devuelve el método o la función actual.

   Debería volver a estar en el bucle For del método Main, detenido en la llamada al método SendMessage.

4. Presione F11 varias veces hasta que vuelva a la llamada al método SendMessage.

5. Mientras la ejecución del código está en pausa en la llamada de método, presione F10 una vez (o bien, elija Depurar > Paso a paso por procedimientos).

   

   En este caso, tenga en cuenta que el depurador no depura paso a paso por instrucciones el método SendMessage. F10 hace avanzar el depurador sin depurar las funciones o los métodos en el código de la aplicación paso a paso por instrucciones (el código todavía se ejecuta). Al presionar F10 en la llamada de método SendMessage (en vez de F11), se omite el código de implementación de SendMessage (algo que quizás no nos interese en este momento). Para más información sobre las distintas formas de desplazarse por el código, vea Navegación por el código en el depurador.

En este artículo, usamos métodos abreviados de teclado porque son una buena forma de ejecutar rápidamente la aplicación en el depurador, pero los comandos equivalentes, como los comandos de menú, se muestran entre paréntesis.

1. Mientras la ejecución del código está en pausa en el bucle For del método Main, presione F11 dos veces (o bien elija Depurar > Depurar paso a paso por instrucciones) para avanzar a la llamada al método SendMessage.

   Después de presionar F11 dos veces, debería estar en esta línea de código:

   SendMessage(name, a(i))

2. Presione F11 una vez más para entrar en el método SendMessage.

   El puntero de color amarillo avanza hasta el método SendMessage.

   

   F11 es el comando Depurar paso a paso por instrucciones y permite avanzar la ejecución de la aplicación de instrucción en instrucción. F11 es una buena forma de examinar el flujo de ejecución con más detalle. Más adelante le mostraremos otras opciones para moverse más rápido por el código. De forma predeterminada, el depurador omite el código que no es de usuario (si quiere más detalles, vea Solo mi código).

   Imagine que ha terminado de examinar el método SendMessage y quiere salir de él, pero permanecer en el depurador. Puede hacerlo con el comando Salir de la depuración.

3. Presione Mayús + F11 (o Depurar > Salir de la depuración).

   Este comando reanuda la ejecución de la aplicación (y hace avanzar el depurador) hasta que se devuelve el método o la función actual.

   Debería volver a estar en el bucle For del método Main, detenido en la llamada al método SendMessage.

4. Presione F11 varias veces hasta que vuelva a la llamada al método SendMessage.

5. Mientras la ejecución del código está en pausa en la llamada de método, presione F10 una vez (o bien, elija Depurar > Paso a paso por procedimientos).

   

   En este caso, tenga en cuenta que el depurador no depura paso a paso por instrucciones el método SendMessage. F10 hace avanzar el depurador sin depurar las funciones o los métodos en el código de la aplicación paso a paso por instrucciones (el código todavía se ejecuta). Al presionar F10 en la llamada de método SendMessage (en vez de F11), se omite el código de implementación de SendMessage (algo que quizás no nos interese en este momento). Para más información sobre las distintas formas de desplazarse por el código, vea Navegación por el código en el depurador.

1. Presione F5 para volver a avanzar hasta el punto de interrupción.

2. En el editor de código, desplácese hacia abajo y mantenga el puntero sobre el método Console.WriteLine del método SendMessage hasta que aparezca el botón Ejecutar hasta clic de color verde. La información sobre herramientas del botón muestra "Ejecutar hasta aquí".

   

   Nota:

   El botón Run to Click (Ejecutar hasta hacer clic) es una novedad de Visual Studio 2017. (Si no ve el botón con la flecha de color verde, presione F11 en este ejemplo para hacer avanzar el depurador hasta el lugar correcto).

3. Seleccione el botón Ejecutar hasta clic.

   El depurador avanza hasta el método Console.WriteLine.

   Usar este botón es similar a establecer un punto de interrupción temporal. La característica Ejecutar hasta clic es útil para desplazarse rápidamente por un área visible del código de la aplicación (puede seleccionar en cualquier archivo abierto).

1. Presione F5 para volver a avanzar hasta el punto de interrupción.

2. En el editor de código, desplácese hacia abajo y mantenga el puntero sobre el método Console.WriteLine del método SendMessage hasta que aparezca el botón Ejecutar hasta clic de color verde. La información sobre herramientas del botón muestra "Ejecutar hasta aquí".

   

3. Seleccione el botón Ejecutar hasta clic.

   El depurador avanza hasta el método Console.WriteLine.

   Usar este botón es similar a establecer un punto de interrupción temporal. La característica Ejecutar hasta clic es útil para desplazarse rápidamente por un área visible del código de la aplicación (puede seleccionar en cualquier archivo abierto).

Seleccione el botón Reiniciar en la barra de herramientas de depuración (Ctrl + Mayús + F5).

El botón Reiniciar permite ahorrar tiempo, ya que hace que no sea necesario detener la aplicación y reiniciar el depurador. El depurador se detiene en el primer punto de interrupción que se alcanza al ejecutar el código.

El depurador se detiene de nuevo en el punto de interrupción que ha establecido antes dentro del bucle For.

Para reiniciar la aplicación, presione la combinación de teclas Ctrl + Mayús + F5, que le permite ahorrar tiempo, ya que no es necesario detener la aplicación y reiniciar el depurador. El depurador se detiene en el primer punto de interrupción que se alcanza al ejecutar el código.

El depurador se detiene de nuevo en el punto de interrupción que ha establecido antes dentro del bucle For.

Las características que le permiten inspeccionar las variables son una de las más útiles del depurador y ofrecen diferentes formas de hacerlo. A menudo, para depurar un problema, debe intentar averiguar si las variables están almacenando los valores que espera que tengan en un momento determinado.

1. Mientras la ejecución del código está en pausa en la instrucción name += letters[i], mantenga el mouse sobre la variable letters y verá su valor predeterminado, el valor del primer elemento de la matriz "f"c.

2. Después, mantenga el mouse sobre la variable name y verá su valor actual, una cadena vacía.

3. Presione F5 varias veces (o bien, seleccione Depurar>Continuar) para iterar varias veces por el bucle For, deténgase de nuevo en el punto de interrupción y mantenga el mouse sobre la variable name cada vez para comprobar su valor.

   

   El valor de la variable cambia con cada iteración del bucle For y muestra los valores de f, después, fr, luego, fre, etc.

   A menudo, al realizar una depuración, queremos una forma rápida de comprobar los valores de las propiedades de las variables para ver si se almacenan los valores correspondientes, y las sugerencias de datos son una buena forma de verlo.

Las características que le permiten inspeccionar las variables son una de las más útiles del depurador y ofrecen diferentes formas de hacerlo. A menudo, para depurar un problema, debe intentar averiguar si las variables están almacenando los valores que espera que tengan en un momento determinado.

1. Mientras la ejecución del código está en pausa en la instrucción name += letters[i], mantenga el mouse sobre la variable letters y verá su valor predeterminado, el valor del primer elemento de la matriz "f"c.

2. Después, mantenga el mouse sobre la variable name y verá su valor actual, una cadena vacía.

3. Presione F5 varias veces (o bien, seleccione Depurar>Continuar) para iterar varias veces por el bucle For, deténgase de nuevo en el punto de interrupción y mantenga el mouse sobre la variable name cada vez para comprobar su valor.

   

   El valor de la variable cambia con cada iteración del bucle For y muestra los valores de f, después, fr, luego, fre, etc.

   A menudo, al realizar una depuración, queremos una forma rápida de comprobar los valores de las propiedades de las variables para ver si se almacenan los valores correspondientes, y las sugerencias de datos son una buena forma de verlo.

1. Vea la ventana Automático, en la parte inferior del editor de código.

   Si está cerrada, ábrala mientras la ejecución del código está en pausa en el depurador seleccionando Depurar>Ventanas>Automático.

   En la ventana Automático puede ver las variables y su valor actual. En la ventana Automático se muestran todas las variables que se usan en la línea actual o en la anterior. Para consultar el comportamiento específico de los lenguajes, vea la documentación.

2. A continuación, examine la ventana Variables locales en una pestaña situada junto a la ventana Automático.

3. Expanda la variable letters para mostrar los elementos que contiene.

   

   En la ventana Variables locales se muestran las variables que se encuentran en el ámbito actual, es decir, en el contexto de ejecución actual.

1. Vea la ventana Automático, en la parte inferior del editor de código.

   Si está cerrada, ábrala mientras la ejecución del código está en pausa en el depurador seleccionando Depurar>Ventanas>Automático.

   En la ventana Automático puede ver las variables y su valor actual. En la ventana Automático se muestran todas las variables que se usan en la línea actual o en la anterior. Para consultar el comportamiento específico de los lenguajes, vea la documentación.

2. A continuación, examine la ventana Variables locales en una pestaña situada junto a la ventana Automático.

3. Expanda la variable letters para mostrar los elementos que contiene.

   

   En la ventana Variables locales se muestran las variables que se encuentran en el ámbito actual, es decir, en el contexto de ejecución actual.

En la ventana del editor de código principal, haga clic con el botón derecho en la variable name y elija Agregar inspección.

En la parte inferior del editor de código se abre la ventana Inspección. Puede usar una ventana Inspección para especificar una variable (o una expresión) que quiera supervisar.

Ahora, ha establecido una inspección en la variable name y puede ver cómo cambia su valor según avanza en el depurador. A diferencia de las otras ventanas de variables, en la ventana Inspección siempre se muestran las variables que está viendo (y se atenúan cuando están fuera del ámbito).

Puede especificar una variable, o una expresión, que quiera vigilar a medida que avanza por el código agregándola a la ventana Inspección.

1. Mientras el depurador está en pausa, haga clic con el botón derecho en la variable name y elija Agregar inspección.

   La ventana Inspección se abre de forma predeterminada en la parte inferior del editor de código.

2. Ahora que ha establecido una inspección sobre la variable name, avance por el código para ver que el valor de la variable name cambia con cada iteración del bucle for.

   A diferencia de las otras ventanas de variables, en la ventana Inspección siempre se muestran las variables que está viendo. Las variables que están fuera del ámbito se muestran como no disponibles.

Para obtener más información sobre la ventana Inspección, consulte Inspección de variables con las ventanas de inspección.

1. Mientras la ejecución del código está en pausa en el bucle For, seleccione la ventana Pila de llamadas, que se abrirá de forma predeterminada en el panel inferior derecho.

   Si está cerrada, ábrala mientras la ejecución del código está en pausa en el depurador seleccionando Depurar>Ventanas>Pila de llamadas.

2. Presione F11 varias veces hasta que vea que el depurador se detiene en el método SendMessage. Eche un vistazo a la ventana Pila de llamadas.

   

   En la ventana Pila de llamadas se muestra el orden en el que se llama a los métodos y las funciones. En la línea superior se muestra la función actual (el método SendMessage en esta aplicación). En la segunda línea se mostrará que se ha llamado a SendMessage desde el método Main, y así sucesivamente.

   Nota

   La ventana Pila de llamadas es similar a la perspectiva de depuración de algunos IDE, como Eclipse.

   La pila de llamadas es una buena forma de examinar y entender el flujo de ejecución de una aplicación.

   Puede hacer doble clic en una línea de código para ver ese código fuente. De este modo, también puede cambiar el ámbito actual bajo inspección por el depurador. Esta acción no hace avanzar el depurador.

   También puede usar los menús contextuales de la ventana Pila de llamadas para hacer otras cosas. Por ejemplo, puede insertar puntos de interrupción en funciones especificadas, avanzar el depurador mediante Ejecutar hasta el cursor y examinar el código fuente. Para obtener más información, vea Cómo: Examinar la pila de llamadas.

1. Mientras la ejecución del código está en pausa en el bucle For, seleccione la ventana Pila de llamadas, que se abrirá de forma predeterminada en el panel inferior derecho.

   Si está cerrada, ábrala mientras la ejecución del código está en pausa en el depurador seleccionando Depurar>Ventanas>Pila de llamadas.

2. Presione F11 varias veces hasta que vea que el depurador se detiene en el método SendMessage. Eche un vistazo a la ventana Pila de llamadas.

   

   En la ventana Pila de llamadas se muestra el orden en el que se llama a los métodos y las funciones. En la línea superior se muestra la función actual (el método SendMessage en esta aplicación). En la segunda línea se mostrará que se ha llamado a SendMessage desde el método Main, y así sucesivamente.

   Nota

   La ventana Pila de llamadas es similar a la perspectiva de depuración de algunos IDE, como Eclipse.

   La pila de llamadas es una buena forma de examinar y entender el flujo de ejecución de una aplicación.

   Puede hacer doble clic en una línea de código para ver ese código fuente. De este modo, también puede cambiar el ámbito actual bajo inspección por el depurador. Esta acción no hace avanzar el depurador.

   También puede usar los menús contextuales de la ventana Pila de llamadas para hacer otras cosas. Por ejemplo, puede insertar puntos de interrupción en funciones especificadas, avanzar el depurador mediante Ejecutar hasta el cursor y examinar el código fuente. Para obtener más información, vea Cómo: Examinar la pila de llamadas.