Visualización y cambio de valores de variables con sugerencias de datos en el editor de código
En este artículo se explora cómo trabajar con la característica de sugerencias de datos en Visual Studio. Las recomendaciones sobre datos son una manera útil de ver información sobre las variables del programa mientras depura el código. Al establecer puntos de interrupción en el código e iniciar la depuración, las recomendaciones sobre datos son visibles para las variables cuando entran en el ámbito de ejecución actual. Use las recomendaciones sobre datos para cambiar el valor de una variable en el ámbito y volver a ejecutar el código en el punto de interrupción para ver el efecto del cambio.
Sugerencia
Si eres nuevo en la depuración, es posible que quieras leer Depuración para principiantes absolutos y Técnicas y herramientas de depuración antes de abordar este artículo.
Prerrequisitos
Visual Studio. Si no tiene Visual Studio, vaya a la página de descargas de Visual Studio para instalarlo de forma gratuita.
Código de programa que se va a ejecutar en el depurador de Visual Studio.
Trabajar con recomendaciones sobre datos
Las recomendaciones sobre datos son visibles durante una sesión de depuración cuando se tienen puntos de interrupción establecidos en el código. Cuando el depurador pause la ejecución del programa en un punto de interrupción, las recomendaciones sobre datos estarán disponibles para las variables del ámbito actual.
A partir de la versión 17.14 de Visual Studio 2022, también puede ver sugerencias de datos para expresiones LINQ.
Este es el proceso:
Establezca un punto de interrupción en el código e inicie la depuración seleccionando Depurar>Iniciar depuración o use el método abreviado de teclado F5.
Cuando el depurador pause la ejecución en el punto de interrupción, mantenga el puntero sobre cualquier variable del ámbito actual para abrir la recomendación sobre datos.
Utilice la recomendación sobre datos para ver el nombre de la variable y trabajar con el valor.
Según sea necesario, cambie el valor de una variable o agregue comentarios.
Nota:
Visual Studio evalúa y muestra el valor de la variable en una recomendación sobre datos en función del contexto en el que se pause el depurador en la ejecución. La evaluación no se basa en la ubicación actual del cursor o la recomendación sobre datos. Si se mantiene el cursor sobre una variable en otra función que tenga el mismo nombre que una variable en el contexto actual, Visual Studio mostrará el valor de la variable en la recomendación de datos del contexto actual.
Visual Studio admite muchas acciones para recomendación sobre datos y el trabajo con las variables y valores, entre los que se incluyen:
- Anclar o hacer flotante una recomendación sobre datos para mantenerla visible a medida que continúe la ejecución del código
- Hacer que las recomendación sobre datos sean transparentes
- Habilite las recomendaciones sobre datos persistentes para que permanezcan expandidas hasta que seleccione en otro lugar
- Expanda la recomendación sobre datos de una matriz, estructura u objeto para ver sus miembros en un formato de árbol
- Cambie el valor de una variable en una recomendación sobre datos
- Agregue comentarios multilínea a una recomendación sobre datos anclada para tomar nota durante la depuración
- Consejos para importar y exportar datos
Hacer que las recomendación sobre datos sean transparentes
Al mantener el puntero sobre una variable para ver la recomendación sobre datos, es posible hacer que esta sea transparente para ver el código subyacente. Esta acción también activa la transparencia de otras acciones de recomendación en el editor de código, como las definiciones de método y la sintaxis de expresión.
Para habilitar la transparencia, siga estos pasos:
En el editor de Visual Studio Code, seleccione dentro de un indicador de datos y, a continuación, mantenga presionada la tecla Ctrl.
Para mantener la transparencia, mantenga presionada la tecla Ctrl.
Para finalizar la transparencia, deje de seleccionar la tecla CTRL o seleccione en otro lugar.
La transparencia no está disponible para recomendaciones de datos ancladas o flotantes.
Mantener expandidas las recomendaciones sobre datos
En la actualización 1 de Visual Studio 2022 y versiones posteriores, al expandir las recomendaciones sobre datos, es posible mantenerlas expandidas hasta que se seleccione en otro lugar. Esta acción genera una recomendación de datos persistente.
Para que una recomendación sobre datos sea persistente, siga estos pasos:
En Visual Studio, seleccione Depurar>Opciones para abrir el cuadro de diálogo Opciones.
En la pestaña General, desplácese para buscar la opción Mantener abiertas las recomendaciones sobre datos expandidas hasta que se haga clic en otro lugar.
Active la casilla para habilitar la opción fija y seleccione OK.
Cuando la opción persistente se encuentre habilitada, si se expande cualquier recomendación sobre datos en el editor de código, permanecerá expandida.
Anclar recomendaciones sobre datos
Es posible anclar recomendaciones sobre datos para mantenerlas abiertas en la superficie del editor de código. También se puede cambiar la ubicación de la recomendación sobre datos anclada.
Para anclar recomendaciones sobre datos, siga estos pasos:
En el editor de Visual Studio Code, mantenga el puntero sobre una variable para mostrar las recomendaciones sobre datos.
En las recomendaciones sobre datos, utilice el marcador para seleccionar Anclar al origen:
Visual Studio ancla la recomendación sobre datos a un lugar cercano a la variable de la superficie de código. Aparecerá un marcador en el medianil del editor de código situado junto a la línea donde se ancle la recomendación sobre datos.
Seleccione y arrastre la recomendación sobre datos anclada a cualquier ubicación de la superficie del editor de código.
Hacer flotantes (desanclar) las recomendaciones sobre datos
Después de anclar una recomendación sobre datos, es posible desanclarla y hacerla flotante. Una recomendación sobre datos flotante se puede ubicar en cualquier parte del IDE de Visual Studio.
Para hacer flotantes recomendaciones sobre datos, siga estos pasos:
En una recomendación sobre datos anclada, use el marcador para seleccionar Desanclar del origen.
Visual Studio desancla la recomendación sobre datos y le aplica un fondo de color sólido. El marcador de la recomendación sobre datos cambia a la posición desanclada y se quita el marcador del medianil del editor de código.
Seleccione y arrastre la recomendación sobre datos flotante a cualquier ubicación del IDE de Visual Studio.
En caso de colocar la recomendación sobre datos flotante fuera de la superficie del editor de código, el marcador se quitará del menú lateral de la recomendación sobre datos. La opción Anclar al origen solo estará disponible cuando la recomendación sobre datos flotante se coloque en la superficie del editor de código.
Consejos para repinear datos
Después de hacer flotante una recomendación sobre datos, vuelva a anclarla a una ubicación de origen específica de la superficie del editor de código.
Para volver a anclar una recomendación sobre datos flotante, siga estos pasos:
Seleccione y mueva la recomendación sobre datos flotante y colóquela en la superficie del editor de código.
En la recomendación sobre datos flotante, utilice el marcador para seleccionar Anclar al origen.
El marcador cambiará a la posición anclada. La recomendación sobre datos se ancla nuevamente a una ubicación específica del editor de código y un marcador indicando el origen aparecerá en el medianil del editor de código.
Cerrar recomendaciones sobre datos
Hay varias maneras de cerrar recomendaciones sobre datos en Visual Studio.
Al finalizar la sesión de depuración, si tuviera recomendaciones sobre datos abiertas, Visual Studio las cerrará. En caso de iniciar otra sesión de depuración, Visual Studio intentará restablecer cualquier recomendación sobre datos que haya dejado abierta anteriormente.
En la tabla siguiente, se resume cómo se cierran manualmente las recomendaciones sobre datos:
| Cerrar el destino | Acción |
|---|---|
| Recomendación de datos específica | Seleccione la X de la recomendación sobre datos. |
| Todas las recomendaciones sobre datos para un archivo específico | Seleccione Depurar>Borrar todas las recomendaciones sobre datos ancladas a <Nombre de archivo> en la barra de herramientas de Visual Studio. |
| Todos los consejos de datos abiertos | Seleccione Depurar>Borrar todas las recomendaciones sobre datos en la barra de herramientas de Visual Studio. |
Trabajar con variables y valores en recomendaciones sobre datos
Al trabajar con recomendaciones sobre datos en Visual Studio, obtendrá la capacidad de ver detalles sobre variables y objetos, así como de editar valores durante la depuración. Estas funcionalidades son útiles para solucionar problemas rápidos y probar los cambios en el código.
Expandir objetos en recomendaciones sobre datos para ver miembros
Cuando una sugerencia de datos representa una matriz, una estructura o un objeto, puede expandir la vista de la sugerencia de datos para ver los miembros. La vista expandida muestra la información adicional en un formato de árbol jerárquico.
Para expandir la vista de un objeto en una recomendación sobre datos, siga estos pasos:
En una sugerencia de datos para una matriz, estructura o objeto, seleccione la flecha de expansión antes del nombre del elemento para mostrar los miembros. La vista se presenta en formato de árbol:
Para obtener una recomendación sobre datos anclada, seleccione el símbolo más (+) antes del nombre de la variable para expandir la definición.
Continúe seleccionando las flechas de expansión para ver más de la jerarquía de miembros:
Para subir y bajar en la vista expandida, use las teclas de flecha arriba y abajo del mouse o del teclado.
Para anclar un miembro expandido con la recomendación sobre datos anclada original, use el marcador del miembro para seleccionar Anclar al origen. Después de contraer la vista de árbol, los elementos de miembro anclados permanecerán visibles con la recomendación sobre datos anclada.
Editar valores de variable
Otra ventaja de trabajar con sugerencias de datos es la capacidad de editar el valor de una variable o elemento en una sugerencia de datos durante la depuración. Esta funcionalidad es útil para realizar pruebas rápidas de pequeños cambios en el código.
Para editar el valor de una variable o elemento en una sugerencia de datos, siga estos pasos:
En la recomendación sobre datos, seleccione el valor. Visual Studio resalta el valor y hace que esté disponible para su edición.
Escriba un nuevo valor en la recomendación sobre datos y seleccione Escribir.
Tenga en cuenta que algunos valores de variable son de solo lectura. Visual Studio no hace que los valores de solo lectura estén disponibles para su edición.
Uso de comentarios en recomendaciones sobre datos
La región Comentarios de una recomendación sobre datos resulta útil para mantener notas sobre las variables mientras se depura el código. Esta región es un lugar conveniente para realizar un seguimiento de los distintos valores a medida que cambian durante la depuración. Es posible agregar comentarios en una recomendación sobre datos anclada o flotante.
Para usar Comentarios en una recomendación sobre datos, siga estos pasos:
En la recomendación sobre datos, use la flecha doble hacia abajo para seleccionar Expandir para ver el comentario. La flecha doble hacia abajo abrirá la región Comentarios de la recomendación sobre datos, donde es posible agregar notas.
Para agregar un comentario, inserte el cursor en la región Comentarios y escriba texto. La región acepta varias líneas.
Para cerrar la región Comentarios, use la doble flecha hacia arriba para Contraer los comentarios. Los comentarios que escriba permanecerán con la recomendación sobre datos, pero no están visibles actualmente.
Anclar propiedades en recomendaciones sobre datos
Visual Studio admite anclar propiedades en recomendaciones sobre datos ancladas en .NET Core 3.0 y versiones posteriores. Esta característica le permitirá inspeccionar rápidamente objetos por sus propiedades en recomendaciones sobre datos.
Para anclar propiedades en recomendaciones sobre datos, siga estos pasos:
En una recomendación sobre datos anclada, expanda la jerarquía de miembros hasta que vea una propiedad que quiera mantener visible con la recomendación sobre datos.
Use el marcador para la propiedad para anclarla con la recomendación sobre datos. También puede hacer clic con el botón derecho en la propiedad y seleccionar Anclar miembro como favorito.
Visual Studio mueve la propiedad seleccionada a la parte superior de la lista de propiedades del objeto. El nombre de la propiedad y el valor se muestran en la columna derecha de la recomendación sobre datos anclada:
Para desanclar una propiedad de una recomendación sobre datos, seleccione nuevamente el marcador de la propiedad o haga clic con el botón derecho en la propiedad y seleccione Desanclar miembro como favorito.
También es posible alternar la visibilidad de los nombres de propiedad y filtrar las propiedades desancladas en la lista de propiedades del objeto en una recomendación sobre datos:
Para filtrar las propiedades no ancladas, haga clic con el botón derecho en la fila de propiedades de la recomendación sobre datos y seleccione Mostrar solo miembros anclados.
Para alternar la visibilidad de los nombres de propiedad, haga clic con el botón derecho en la fila de propiedades de la recomendación sobre datos y seleccione Ocultar nombres de miembros anclados en valores.
En la imagen siguiente se muestran las distintas opciones del menú contextual de la jerarquía de miembros en una recomendación sobre datos:
Obtención de ayuda para la inteligencia artificial
Si tiene Copilot, obtendrá ayuda de la IA al examinar las variables de las recomendaciones sobre 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 proporcionar contexto en el chat. Para obtener más información, consulte Depurar con Copilot.
A partir de la versión 17.14 de Visual Studio 2022, también obtendrá ayuda de Copilot de las recomendaciones sobre datos para expresiones LINQ.
Visualización de tipos de datos complejos
Los visualizadores muestran información de una manera más significativa y a veces gráfica. Algunos ejemplos de visualizadores son XML, HTML, JSON, Visualizador de textoy los visualizadores tabulares de . Puede usar visualizaciones para examinar tipos de datos complejos en el código durante la depuración.
Si los visualizadores estuvieran disponibles para un elemento, Visual Studio mostrará la lupa Ver junto al nombre del elemento en la recomendación sobre datos. Al seleccionar una visualización, Visual Studio abre una ventana independiente para mostrar los datos complejos en un formato legible.
Puede usar esta característica para seleccionar una visualización de los datos:
Para ver el elemento mediante el visualizador predeterminado para el tipo de datos, seleccione la lupa. Icono del visualizador
Para seleccionar un visualizador específico, expanda la lista desplegable Vista junto a la lupa y elija una opción.
Agregar variables a ventanas de Seguir el hilo
Es posible seguir viendo variables agregándolas a una ventana de Visual Studio Seguir el hilo desde una recomendación sobre datos:
- En la recomendación sobre datos, haga clic con el botón derecho en el nombre de la variable y seleccione Agregar Seguir el hilo.
Visual Studio agregará la variable en la ventana Seguir el hilo. Si la edición de Visual Studio admitiera varias ventanas de Seguir el hilo, la variable aparecerá en la ventana etiquetada como Seguir el hilo 1.
Importación y exportación de recomendaciones sobre datos
Puede exportar sugerencias de datos a un archivo XML, que puede compartir o editar mediante un editor de texto. También puede importar unas sugerencias de datos desde un archivo XML que haya recibido o editado anteriormente.
Para exportar sugerencias de datos, siga estos pasos:
En Visual Studio, seleccione Depurar>Exportar recomendaciones sobre datos. Se abrirá el cuadro de diálogo Exportar recomendaciones sobre datos.
En el cuadro de diálogo, vaya a la ubicación donde desea guardar el archivo XML.
Escriba un nombre para el archivo de exportación y seleccione Guardar.
Visual Studio exporta las recomendaciones sobre datos al archivo y la ubicación especificados.
Para importar sugerencias de datos desde un archivo, siga estos pasos:
En Visual Studio, seleccione Depurar>Importar recomendaciones sobre datos. Se abrirá el cuadro de diálogo Importar recomendaciones sobre datos.
En el cuadro de diálogo, vaya a la ubicación del archivo XML de recomendaciones sobre datos que se usará para la importación.
Seleccione el archivo que desea abrir y seleccione Abrir.
Visual Studio importará las recomendaciones sobre datos del archivo especificado en el área de trabajo actual. Al depurar el código del área de trabajo, estarán disponibles las recomendaciones sobre datos importadas.