在代码编辑器中查看数据提示中的数据值

  • 项目

使用数据提示功能，可以在调试期间方便地查看程序中变量的有关信息。 数据提示功能只能在中断模式下可用，并且只对当前执行范围内的变量有效。 如果是首次尝试调试代码，那么在阅读本文前，可能需要阅读零基础调试和调试技术和工具。

使用数据提示

数据提示功能只在中断模式下可用，并且只对当前执行范围内的变量有效。

显示数据提示

  1. 在代码中设置断点，然后按 F5 或选择“调试”>“开始调试”以开始调试 。

  2. 在断点处暂停时，将鼠标悬停在当前范围内的任何变量上。 将会出现数据提示，其中显示变量的名称和当前值。

使数据提示显示为透明

若要使数据提示显示为透明以便查看其下方的代码，请在数据提示中按 Ctrl。 只要按住 Ctrl 键，数据提示就会保持透明状态。 此操作不适用于固定或浮动的数据提示。

保持数据提示展开

从 Visual Studio 2022 Update 1 开始，展开数据提示后，可以使其保持展开，直到你单击其他位置。 这称为粘滞数据提示。 若要启用此功能，请选择“工具”>“选项”>“调试”，然后在“常规”选项卡中，选择“保持展开的数据提示打开，直到单击离开”。

固定数据提示

若要固定数据提示以使其保持打开状态，请选择图钉“固定到源”图标。

Pin a data tip

可以通过在代码窗口中拖动固定的数据提示来移动它。 在数据提示固定到的行旁边的装订线中会显示一个图钉图标。

注意

数据提示始终在执行暂停的上下文中进行评估，而不是在当前光标位置或数据提示位置。 如果将鼠标指针悬停在另一函数中的变量的上方，且该变量与当前上下文中的某个变量同名，则会显示当前上下文中的变量的值。

从源中取消固定数据提示

若要将已固定的数据提示设置为浮动状态，请将鼠标悬停在数据提示上，然后从上下文菜单中选择图钉图标。

图钉图标将更改至取消固定的位置，并且数据提示现在处于浮动状态，也可将其拖动到所有打开的窗口上方。 在调试会话结束时，浮动的数据提示将关闭。

重新固定数据提示

若要将浮动的数据提示重新固定到源，请将鼠标悬停在代码编辑器中，然后选择图钉图标。 图钉图标将变换到固定的位置，数据提示会再次仅固定到代码窗口。

如果数据提示浮动在非源代码窗口上，图钉图标将不可用，并且无法重新固定数据提示。 若要找到图钉图标，请将数据提示拖动回代码编辑器窗口，或通过将焦点转至代码窗口来让数据提示回到代码编辑器窗口。

关闭数据提示

若要关闭数据提示，请将鼠标悬停在数据提示上，然后从上下文菜单中选择关闭 (x) 图标。

关闭所有数据提示

若要关闭所有数据提示，请在“调试”菜单上选择“清除所有数据提示”。

关闭特定文件的所有数据提示

若要关闭特定文件的所有数据提示，请在“调试”菜单上选择“清除固定到 <Filename> 的所有数据提示”。

展开并编辑信息

利用数据提示功能，可以展开数组、结构或对象以查看其成员。 还可以从数据提示编辑变量的值。

展开变量

若要在数据提示中展开某个对象以查看其元素，请将鼠标悬停在该项的名称之前的展开箭头上，以树状显示其元素。 对于固定的数据提示，请选择变量名称前面的 + 并展开元素树。

Expand a data tip

可以使用鼠标或键盘上的箭头键在展开的视图中上下移动。

若要将展开的项固定到固定的数据提示，请将鼠标悬停在项上并选择其图钉图标。 折叠树后，这些元素会显示在固定的数据提示中。

编辑变量的值

若要在数据提示中编辑某个变量或元素的值，请选择该值，键入新值，然后按 Enter。 禁止选择只读值。

在数据提示中固定属性

注意

.NET Core 3.0 或更高版本支持此功能。

使用“可固定属性”工具，可以按属性快速检查数据提示中的对象。 要使用此工具，请将鼠标悬停在某个属性上，并选择出现的固定图标，或右键单击并选择所显示上下文菜单中的“将成员固定到收藏夹”选项。 这会将该属性以气泡形式显示到该对象的属性列表顶部，并且属性名称和值会显示在数据提示的右列中。 要取消固定属性，请再次选择固定图标，或在上下文菜单中选择“取消将成员固定到收藏夹”选项。

Pinning a property in a data tip

在数据提示中查看对象的属性列表时，还可以切换属性名称并筛选出非固定属性。 若要采用其中任一选项，请右键单击包含属性的行并在上下文菜单中选择“仅显示已固定的成员”或“在值中隐藏已固定的成员名称”选项 。

可视化复杂数据类型

在数据提示中，变量或元素旁边的放大镜图标表示有一个或多个可视化工具（例如文本可视化工具）可用于该变量。 可视化工具能以更有意义的方式（有时是图形）显示信息。

若要使用数据类型的默认可视化工具来查看元素，请选择放大镜图标Visualizer icon。 选择放大镜图标旁边的箭头，从该数据类型的可视化工具列表中进行选择。

将变量添加到监视窗口

如果要继续监视某个变量，可在数据提示中将其添加到“监视”窗口。 在数据提示中右键单击该变量，然后选择“添加监视”。

变量随即会显示在“监视”窗口中。 如果使用的 Visual Studio 版本支持多个“监视”窗口，则该变量将显示在“监视 1”中 。

导入和导出数据提示

可以将数据提示导出到 XML 文件中，然后能将其共享给其他人，或者使用文本编辑器来对其进行编辑。 还可以导入已接收或编辑的数据提示 XML 文件。

导出数据提示：

  1. 选择“调试”>“导出数据提示” 。

  2. 在“导出数据提示”对话框中，导航到要保存 XML 文件的位置，键入文件名，然后选择“保存” 。

导入数据提示：

  1. 选择“调试”>“导入数据提示” 。

  2. 在“导入数据提示”对话框中，选择要打开的数据提示 XML 文件，然后选择“打开”。

相关内容