Consulta de valores en la Información sobre datos en el editor de código

  • Artículo

La información sobre datos es una manera útil de ver información sobre las variables del programa durante la depuración. La información sobre datos funciona únicamente en modo de interrupción y únicamente con las variables que están dentro del actual ámbito de ejecución. 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.

Trabajar con información sobre datos

La información sobre datos aparece únicamente en modo de interrupción y solo con las variables que están dentro del actual ámbito de ejecución.

Mostrar información sobre datos

  1. Establezca un punto de interrupción en el código e inicie la depuración presionando F5 o seleccionando Depurar>Iniciar depuración.

  2. Cuando pause el punto de interrupción, mantenga el puntero sobre cualquier variable del ámbito actual. Aparecerá la información sobre datos, en la que se mostrarán el nombre y el valor actual de la variable.

Hacer que la información sobre datos sea transparente

Para que la información sobre datos sea transparente y ver el código que está debajo, presione Ctrl mientras se encuentra en la información sobre datos. La información sobre datos permanecerá transparente mientras mantenga presionada la tecla Ctrl. Esto no funciona para información sobre datos anclada o flotante.

Mantener expandida la información sobre datos

A partir de Visual Studio 2022 Update 1, al expandir la información sobre datos, puede mantenerlo expandido hasta que haga clic en otro lugar. Esto se denomina información sobre datos pegajosa. Para habilitar esta característica, seleccione Herramientas>Opciones>Depuración y, después, en la pestaña General, seleccione Keep expanded data tips open until clicked away (Mantener las sugerencias de datos expandidas abiertas hasta que se haga clic en ella).

Anclar la información sobre datos

Para anclar la información sobre datos de modo que permanezca abierta, seleccione el icono de marcador Anclar a origen.

Pin a data tip

Puede mover la información sobre datos anclada arrastrándola alrededor de la ventana de código. Aparece un icono de marcador en el medianil junto a la línea a la que está anclada la información sobre datos.

Nota

Las informaciones sobre datos siempre se evalúan en el contexto en el que se suspende la ejecución, y no con respecto al cursor actual o la ubicación de la información sobre datos. Si mantiene el cursor sobre una variable en otra función que tenga el mismo nombre que una variable en el contexto actual, se mostrará el valor de la variable del contexto actual.

Desanclar la información sobre datos del origen

Para hacer que la información sobre datos anclada sea flotante, mantenga el puntero sobre la información sobre datos y seleccione el icono de marcador en el menú contextual.

El icono de marcador cambia a la posición desanclada y la información sobre datos ahora es flotante o se puede arrastrar encima de las ventanas abiertas. La información sobre datos que flota se cierra cuando la sesión de depuración finaliza.

Volver a anclar la información sobre datos

Para volver a anclar la información sobre datos flotante al origen, mantenga el puntero sobre ella en el editor de código y seleccione el icono de marcador. El icono de marcador cambia a la posición anclada y la información sobre datos se vuelve a anclar solo a la ventana de código.

Si la información sobre datos está flotando sobre una ventana que no es parte del código fuente, el icono de marcador no estará disponible y la información sobre datos no se podrá volver a anclar. Para acceder al icono de marcador, vuelva a poner la información sobre datos de la ventana del editor de código arrastrándola o centrándose en la ventana de código.

Cerrar la información sobre datos

Para cerrar la información sobre datos, mantenga el puntero sobre la información sobre datos y seleccione el icono de cierre (x) en el menú contextual.

Cerrar toda la información sobre datos

Para cerrar toda la información sobre datos, en el menú Depurar, seleccione Clear All data tips (Borrar toda la información sobre datos).

Cierre de toda la información sobre datos de un archivo concreto

Para cerrar toda la información sobre datos de un archivo concreto, en el menú Depurar, seleccione Clear All data tips Pinned to <Filename> (Borrar toda la información sobre datos anclada a <nombre de archivo>).

Expansión y edición de la información

Con la información sobre datos, se puede expandir una matriz, una estructura o un objeto para ver sus miembros. También se puede editar el valor de una variable de la información sobre datos.

Expansión de una variable

Para expandir un objeto de la información sobre datos y ver sus elementos, mantenga el puntero sobre las flechas para expandir delante de los nombres de elementos para mostrar los elementos en forma de árbol. Para información sobre datos anclada, seleccione + antes del nombre de la variable y, después, expanda el árbol.

Expand a data tip

Puede utilizar el mouse o las teclas de dirección en el teclado para desplazarse de arriba abajo en la vista expandida.

También puede anclar los elementos expandidos a la información sobre datos anclada manteniendo el puntero sobre ellos y seleccionando sus iconos de marcador. Los elementos aparecen en la información sobre datos anclada después de contraerse el árbol.

Edición del valor de una variable

Para editar el valor de una variable o un elemento en la información sobre datos, seleccione el valor, escriba uno nuevo y presione Entrar. La selección está deshabilitada en los valores de solo lectura.

Anclar propiedades en información sobre datos

Nota

Esta característica se admite en .NET Core 3.0 o versiones posteriores.

Puede inspeccionar rápidamente los objetos según sus propiedades en la información sobre datos con la herramienta para anclar propiedades. Para usar esta herramienta, mantenga el puntero sobre una propiedad y seleccione el icono para 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 derecha de la información sobre datos. Para desanclar una propiedad, vuelva a seleccionar el icono para anclar o seleccione la opción Desanclar miembro como favorito en el menú contextual.

Pinning a property in a data tip

También puede alternar los nombres de propiedades y filtrar las no ancladas al consultar la lista de propiedades del objeto en la información sobre datos. Para acceder a cualquiera de las opciones, haga clic con el botón derecho en una fila que contenga una propiedad y seleccione las opciones Mostrar solo miembros anclados u Ocultar nombres de miembros anclados en valores en el menú contextual.

Visualización de tipos de datos complejos

Un icono de lupa situado junto a una variable o un elemento de la información sobre datos significa que uno o varios visualizadores, como el Visualizador de texto, están disponibles para la variable. Los visualizadores muestran información en un modo más significativo y, a veces, más gráfico.

Para ver el elemento con el visualizador predeterminado del tipo de datos, seleccione el icono de lupa Visualizer icon. Seleccione la flecha situada junto al icono de lupa para seleccionarlo en una lista de visualizadores para el tipo de datos.

Adición de una variable a la ventana Inspección

Si quiere seguir examinando una variable, puede agregarla a una ventana Inspección desde la información sobre datos. Haga clic con el botón derecho en la variable en la información sobre datos y seleccione Agregar inspección.

La variable aparece en la ventana Inspección. Si la edición de Visual Studio admite más de una ventana Inspección, la variable aparece en Inspección 1.

Importación y exportación de información sobre datos

Puede exportar información sobre datos en un archivo XML que puede compartir o editar mediante un editor de texto. También puede importar un archivo XML de información sobre datos que haya recibido o editado.

Para exportar sugerencias de datos:

  1. Seleccione Depurar>Exportar información sobre datos.

  2. En el cuadro de diálogo Exportar información sobre datos, vaya a la ubicación para guardar el archivo XML, escriba un nombre para el archivo y, a continuación, seleccione Guardar.

Para importar sugerencias de datos:

  1. Seleccione Depurar>Importar información sobre datos.

  2. En el cuadro de diálogo Import data tips (Importar información sobre datos), seleccione el archivo XML de información sobre datos que quiera abrir y, después, seleccione Abrir.

Contenido relacionado