View data values in DataTips in the code editor

Applies to: yesVisual Studio noVisual Studio for Mac

> [!NOTE] > This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it herer

Data tips provide a convenient way to view information about variables in your program during debugging. Data tips work only in break mode and only with variables that are in the current scope of execution. If this is the first time that you've tried to debug code, you may want to read Debugging for absolute beginners and Debugging techniques and tools before going through this article.

Work with data tips

Data tips appear only in break mode, and only on variables that are in the current scope of execution.

Display a data tip

  1. Set a breakpoint in your code, and start debugging by pressing F5 or selecting Debug > Start Debugging.

  2. When paused at the breakpoint, hover over any variable in the current scope. A data tip appears, showing the name and current value of the variable.

Make a data tip transparent

To make a data tip transparent to see code that is underneath it, while in the data tip, press Ctrl. The data tip stays transparent as long as you hold down the Ctrl key. This doesn't work for pinned or floating data tips.

Pin a data tip

To pin a data tip so that it stays open, select the pushpin Pin to source icon.

Pin a data tip

You can move a pinned data tip by dragging it around the code window. A pushpin icon appears in the gutter next to the line the data tip is pinned to.

Note

Data tips are always evaluated in the context where execution is suspended, not the current cursor or data tip location. If you hover over a variable in another function that has the same name as a variable in the current context, the value of the variable in the current context is displayed.

Unpin a data tip from source

To float a pinned data tip, hover over the data tip and select the pushpin icon from the context menu.

The pushpin icon changes to the unpinned position, and the data tip now floats or can be dragged above all open windows. Floating data tips close when the debugging session ends.

Repin a data tip

To repin a floating data tip to source, hover over it in the code editor and select the pushpin icon. The pushpin icon changes to the pinned position, and the data tip is again pinned only to the code window.

If a data tip is floating over a non-source code window, the pushpin icon is unavailable, and the data tip cannot be repinned. To access the pushpin icon, return the data tip to the code editor window by dragging it or giving the code window focus.

Close a data tip

To close a data tip, hover over the data tip and select the close (x) icon from the context menu.

Close all data tips

To close all data tips, on the Debug menu, select Clear All data tips.

Close all data tips for a specific file

To close all data tips for a specific file, on the Debug menu, select Clear All data tips Pinned to <Filename>.

Expand and edit information

You can use data tips to expand an array, a structure, or an object to view its members. You can also edit the value of a variable from a data tip.

Expand a variable

To expand an object in a data tip to see its elements, hover over the expand arrows before the item names to display the elements in tree form. For a pinned data tip, select the + before the variable name and then expand the tree.

Expand a data tip

You can use the mouse or the arrow keys on the keyboard to move up and down in the expanded view.

You can also pin expanded items to the pinned data tip by hovering over them and selecting their pushpin icons. The elements then appear in the pinned data tip after the tree is collapsed.

Edit the value of a variable

To edit the value of a variable or element in a data tip, select the value, type a new value, and press Enter. Selection is disabled for read-only values.

Visualize complex data types

A magnifying glass icon next to a variable or element in a data tip means that one or more visualizers, such as the Text Visualizer, are available for the variable. Visualizers display information in a more meaningful, sometimes graphical, manner.

To view the element using the default visualizer for the data type, select the magnifying glass icon Visualizer icon. Select the arrow next to the magnifying glass icon to select from a list of visualizers for the data type.

Add a variable to a Watch window

If you want to continue to watch a variable, you can add it to a Watch window from a data tip. Right-click the variable in the data tip, and select Add Watch.

The variable appears in the Watch window. If your Visual Studio edition supports more than one Watch window, the variable appears in Watch 1.

Import and export data tips

You can export data tips to an XML file, which you can share or edit using a text editor. You can also import a data tip XML file you have received or edited.

To export data tips:

  1. Select Debug > Export DataTips.

  2. In the Export DataTips dialog box, navigate to the location to save the XML file, type a name for the file, and then select Save.

To import data tips:

  1. Select Debug > Import DataTips.

  2. In the Import data tips dialog box, select the data tips XML file you want to open, and then select Open.

See also