Inspección de variables en las ventanas Automático y Variables locales

Las ventanas Automático y Variables locales muestran valores de variables durante la depuración. Las ventanas solo están disponibles durante una sesión de depuración. La ventana Automático muestra las variables usadas alrededor de la declaración actual, donde el depurador se pausa. La ventana Variables locales muestra las variables definidas en el ámbito local, que suele ser la función o el método actuales.

Nota:

Si esta es la primera vez que intenta depurar código, le recomendamos que lea Cómo depurar para principiantes sin experiencia y Herramientas y técnicas de depuración antes de continuar con este artículo.

La ventana Automático está disponible para código de C#, Visual Basic, C++ y Python, pero no de JavaScript o F#.

Para abrir la ventana Automático, seleccione Depurar>Ventanas>Automático, o bien presione Ctrl+Alt+V>A durante la depuración.

Para abrir la ventana Variables locales, seleccione Depurar>Ventanas>Variables locales, o bien presione Alt+4 durante la depuración.

Uso de las ventanas Automático y Variables locales

Las matrices y los objetos se muestran en las ventanas Automático y Variables locales como controles de árbol. Seleccione la flecha situada a la izquierda del nombre de una variable para expandir la vista y mostrar los campos y las propiedades. En el ejemplo siguiente se muestra un objeto System.IO.FileStream en la ventana Variables locales:

Un valor en rojo en la ventana Variables locales o Automático indica que el valor ha cambiado desde la última evaluación. La causa del cambio podría ser una sesión de depuración anterior o la modificación del valor en la ventana.

El formato numérico predeterminado de las ventanas del depurador es decimal. Para cambiarlo a hexadecimal, haga clic con el botón derecho en la ventana Variables locales o Automático y seleccione Presentación hexadecimal. El cambio afecta a todas las ventanas del depurador.

Edición de valores de variable en las ventanas Automático y Variables locales

Para editar los valores de la mayoría de las variables en las ventanas Automático o Variables locales, haga doble clic en el valor y escriba el nuevo valor.

Puede escribir una expresión para un valor; por ejemplo, a + b. El depurador acepta la mayoría de las expresiones de lenguaje válidas.

En el código C++ nativo, se debe calificar el contexto de un nombre de variable. Para obtener más información, vea Operador de contexto en el depurador de Visual Studio (C++).

Precaución

Asegúrese de que comprende las consecuencias antes de cambiar valores y expresiones. Estas son algunos problemas posibles:

• La evaluación de algunas expresiones puede cambiar el valor de una variable o afectar de otra forma al estado del programa. Por ejemplo, al evaluar var1 = ++var2 se cambia el valor de var1 y var2. Se dice que estas expresiones tienen efectos secundarios. Los efectos secundarios pueden producir resultados inesperados si no se tienen en cuenta.

• La modificación de valores de punto flotante puede dar lugar a ligeras imprecisiones debido a la conversión de decimal a binario de los componentes fraccionarios. Incluso una operación de edición aparentemente inofensiva puede causar cambios en alguno de los bits de la variable de punto flotante.

Búsqueda en las ventanas Automático o Variables locales

Puede buscar palabras clave en las columnas Nombre, Valor y Tipo de la ventana Automático o Variables locales mediante la barra de búsqueda situada encima de cada ventana. Presione Entrar o seleccione una de las flechas para ejecutar una búsqueda. Para cancelar una búsqueda en curso, seleccione el icono "x" en la barra de búsqueda.

Use las flechas izquierda y derecha (Mayús+F3 y F3, respectivamente) para desplazarse por las coincidencias encontradas.

Para que la búsqueda sea más o menos exhaustiva, use la lista desplegable Profundizar la búsqueda en la parte superior de la ventana Automático o Variables locales para seleccionar en cuántos niveles de profundidad quiere buscar objetos anidados.

Anclaje de propiedades en la ventana Automático o Variables locales

Nota

Esta característica es compatible con .NET Core 3.0 o versiones posteriores.

Puede inspeccionar rápidamente objetos por sus propiedades en las ventanas Automático y Variables locales con la herramienta para anclar propiedades. Para usar esta herramienta, mantenga el puntero sobre una propiedad y seleccione el icono Anclar que aparece o haga clic con el botón derecho y seleccione la opción Anclar miembro como favorito en el menú contextual resultante. Esta propiedad se propaga a la parte superior de la lista de propiedades del objeto, y el nombre y el valor de la propiedad se muestran en la columna Valor. Para desanclar una propiedad, vuelva a seleccionar el icono para anclar o seleccione la opción Desanclar miembro como favorito en el menú contextual.

También puede alternar los nombres de propiedades y filtrar las no ancladas al consultar la lista de propiedades del objeto en las ventanas Automático o Variables locales. Puede acceder a ambas opciones seleccionando los botones en la barra de herramientas situada encima de las ventanas Automático o Variables locales.

Cambio del contexto de la ventana Automático o Variables locales

Puede usar la barra de herramientas Ubicación de depuración para seleccionar la función, el subproceso o el proceso que quiera, lo que cambia el contexto de las ventanas Automático y Variables locales.

Para habilitar la barra de herramientas Ubicación de depuración, haga clic en una parte vacía del área de la barra de herramientas y seleccione Ubicación de depuración en la lista desplegable, o bien seleccione Ver>Barras de herramientas>Ubicación de depuración.

Establezca un punto de interrupción e inicie la depuración. Cuando se alcanza el punto de interrupción, la ejecución se pausa y puede verse la ubicación en la barra de herramientas Ubicación de depuración.

Obtenga asistencia de IA

Si tiene Copilot, puede obtener ayuda de IA mientras examina las variables en las ventanas Automático o Variables locales, o bien en las sugerencias de datos. Haga clic con el botón derecho en una variable y use el botón Preguntar a Copilot . En este escenario, Copilot ya conoce el contexto de su pregunta, por lo que no es necesario que proporcione contexto en el chat. Para obtener más información, consulte Depuración con Copilot.

Variables en la ventana Automático (C#, C++, Visual Basic, Python)

Los diferentes lenguajes de código muestran distintas variables en la ventanaAutomático.

• En C# y Visual Basic, la ventana Automático muestra cualquier variable que se usa en la línea actual o anterior. Por ejemplo, en código de C# o Visual Basic, declare las cuatro variables siguientes:

       public static void Main()
       {
          int a, b, c, d;
          a = 1;
          b = 2;
          c = 3;
          d = 4;
       }
  

  Establezca un punto de interrupción en la línea c = 3; e inicie el depurador. Cuando la ejecución se pause, se mostrará la ventana Automático:

  

  El valor de c es 0, porque la línea c = 3 aún no se ha ejecutado.

• En C++, la ventana Automático muestra las variables que se usan en al menos tres líneas anteriores a la línea actual, en la que la ejecución se pausa. Por ejemplo, en código C++, declare seis variables:

       void main() {
           int a, b, c, d, e, f;
           a = 1;
           b = 2;
           c = 3;
           d = 4;
           e = 5;
           f = 6;
       }
  

  Establezca un punto de interrupción en la línea e = 5; y ejecute el depurador. Cuando la ejecución se detenga, se mostrará la ventana Automático:

  

  La variable e no se ha inicializado porque la línea e = 5 aún no se ha ejecutado.

Ver los valores devueltos por las llamadas a métodos

En el código .NET y C++ se pueden examinar los valores en la ventana Automático cuando una llamada al método se ejecuta paso a paso por procedimientos o paso a paso para salir. La visualización de los valores devueltos de la llamada de método puede resultar útil cuando no se almacenan en variables locales. Un método se puede usar como parámetro o como valor devuelto de otro método.

Nota:

A partir de visual Studio 2022, versión 17.12 Preview 3, también puede ver los valores devueltos en línea y no solo en la ventana Automático.

Por ejemplo, el siguiente código C# agrega los valores devueltos de dos funciones:

static void Main(string[] args)
{
    int a, b, c, d;
    a = 1;
    b = 2;
    c = 3;
    d = 4;
    int x = sumVars(a, b) + subtractVars(c, d);
}

private static int sumVars(int i, int j)
{
    return i + j;
}

private static int subtractVars(int i, int j)
{
    return j - i;
}

Para ver los valores devueltos de las llamadas de método sumVars() y subtractVars() en la ventana Automático:

1. Establezca un punto de interrupción en la línea int x = sumVars(a, b) + subtractVars(c, d); .

2. Inicie la depuración y, cuando la ejecución se pause en el punto de interrupción, seleccione Paso a paso por procedimientos o presione F10. Deberían mostrarse los siguientes valores devueltos en la ventana Automático:

   

Contenido relacionado

• ¿Qué es la depuración?
• Herramientas y técnicas de depuración
• Primer vistazo a la depuración
• Ventanas del depurador