IntelliTrace 功能（C#、Visual Basic、C++）

项目
04/30/2024

可以使用 IntelliTrace 记录事件和调用应用程序的方法，它让你能够在执行中的不同位置检查其状态（调用堆栈和局部变量值）。正常启动调试即可，默认启用 IntelliTrace，并且可以在“事件”选项卡下的新“诊断工具”窗口中看到 IntelliTrace 正在记录的信息。选择一个事件，然后单击“激活历史调试”以查看为此事件记录的调用堆栈和局部变量。

有关分步说明，请参阅演练：使用 IntelliTrace。

Visual Studio Enterprise 版中提供 IntelliTrace，但 Visual Studio Professional 或 Community 版中不提供。

若要确认 IntelliTrace 已启用，请打开“工具”>“选项”>“IntelliTrace”选项页。默认情况下应选中“启用 IntelliTrace”。

注意

“IntelliTrace”选项页上的所有设置都针对 Visual Studio 这个整体，而不针对单个项目或解决方案。这些设置中的更改适用于 Visual Studio 的所有实例、所有调试会话和所有项目或解决方案。

选择 IntelliTrace 记录的事件（C#、Visual Basic）

可以启用或禁用针对特定 IntelliTrace 事件的记录。

如果在进行调试，请停止调试。转到“工具”>“选项”>“IntelliTrace”>“IntelliTrace 事件”。选择想要 IntelliTrace 记录的事件。

收集快照（C#、Visual Basic、C++）

默认情况下不启用此功能，但 IntelliTrace 可以在每个断点和调试器单步执行事件中捕获应用程序的快照，可以在历史调试会话中查看这些快照。快照提供完整应用程序状态的视图。若要启用快照捕获，请转到“工具”>“选项”>“IntelliTrace”>“常规”，然后选择“IntelliTrace 快照(托管和本机)”。有关详细信息，请参阅使用 IntelliTrace 检查上一应用状态。

快照功能在 Visual Studio Enterprise 2017 版本 15.5 及更高版本中可用，并且需要 Windows 10 周年更新或更高版本。对于 .NET Core 和 ASP.NET Core 应用，需要 Visual Studio Enterprise 2017 版本 15.7。对于面向 Windows 的本机应用，需要 Visual Studio Enterprise 2017 版本 15.9 预览版 2。

收集 IntelliTrace 事件和调用信息（C#、Visual Basic）

默认情况下不启用此选项，但 IntelliTrace 可以随事件一起记录方法调用。若要启用方法调用的集合，请转到“工具”>“选项”>“IntelliTrace”>“常规”，然后选择“IntelliTrace 事件和调用信息(仅限托管)”。

调用信息当前不可用于 .NET Core 和 ASP.NET Core 应用。

这使你可以查看调用堆栈历史记录以及在代码中的调用间后退和前进。 IntelliTrace 记录的数据包括方法名、方法进入和退出点，以及部分参数值和返回值。

提示

默认情况下不启用此选项，因为它会增加大量开销。 IntelliTrace 不仅需要截获应用程序生成的每个方法调用，当需要在屏幕上显示数据或将数据保留到磁盘时，它还需要处理一组更大的数据。

可以通过限制 IntelliTrace 记录的事件列表以及将收集的模块数保持为最小值来减少性能开销。有关详细信息，请参阅控制 IntelliTrace 记录的调用信息量。

可以使用代码窗口左侧显示的导航线。如果没有看到导航线，请转到“工具”>“选项”>“IntelliTrace”>“高级”，然后选择“在调试模式中显示导航线”。

导航线让你能够在历史调试模式下向前和向后移动方法调用和事件。有关历史调试的详细信息，请参阅历史调试。它拥有多个命令：

命令	描述
在此设置调试器上下文	将调试上下文设置为调用出现的调用时间范围。此图标仅在当前调用堆栈上显示。
返回调用站点	将指针和调试上下文移回调用当前函数的位置。如果处于实时调试模式下，则此命令会启用历史调试。如果向后定位到原始执行中断，则会禁用历史调试并启用实时调试。
转到上一个调用或 IntelliTrace 事件	将指针和调试上下文移回上一个调用或事件。如果处于实时调试模式下，则此命令会启用历史调试。
单步执行	单步执行当前选择的函数。只有处于历史调试模式下时才能使用此命令。
转到下一个调用或 IntelliTrace 事件	将指针和调试上下文移到存在 IntelliTrace 数据的下一个调用或事件。只有处于历史调试模式下时才能使用此命令。
转到实时模式	返回实时调试模式。

在 IntelliTrace 中搜索某行或某个方法

仅当已启用方法调用信息时才可以搜索方法。可以搜索 IntelliTrace 历史记录以查找特定行或方法。暂停调试程序执行时，在函数正文内右键单击以查看上下文菜单，然后单击“在 IntelliTrace 中搜索此行”或“在 IntelliTrace 中搜索此方法” 。

控制 IntelliTrace 记录的调用信息量

默认情况下，IntelliTrace 记录解决方案使用的所有模块的信息。可以将 IntelliTrace 设置为仅记录你感兴趣的模块的调用信息。在“工具”>”选项”>“IntelliTrace”>“模块”中，可以指定 IntelliTrace 要包括或排除的模块。 IntelliTrace 将仅收集你指定的模块中生成的事件，以及你感兴趣的模块内发生的方法调用。

若要添加多个模块，请在字符串的开头或结尾使用通配符 *。对于模块名称，请使用文件名，而不是程序集名称。不接受文件路径。

尝试将模块数保持为最小值。因为要收集的数据变少，所以可以获得更好的性能。 UI 中的噪音也会减少，因为要浏览的数据变少。

将 IntelliTrace 数据保存到文件（C#、Visual Basic、C++）

正在进行调试且应用程序处于中断状态时，通过转到“调试”>“IntelliTrace”>“保存 IntelliTrace 会话”，可以保存 IntelliTrace 收集的数据。如果应用程序仍在运行或如果你已经停止调试，则菜单项会被禁用，且你将无法保存 IntelliTrace 收集的数据。

通过转到“工具”>“选项”>“IntelliTrace”>“高级”并选择“在此目录中存储 IntelliTrace 记录”，可以将 IntelliTrace 配置为自动保存到文件。还可以为生成的文件配置固定大小，这会让 IntelliTrace 在空间不足时覆盖旧数据。自动保存文件并启用 Visual Studio 承载进程 (vshost.exe) 时，Visual Studio 会为每个 IntelliTrace 会话创建两个文件。

提示

为了节省磁盘空间，请在不再需要时禁用自动保存文件。不会删除任何现有文件。可以随时从上下文菜单按需保存到文件。

将 IntelliTrace 数据保存到文件中时，每个 IntelliTrace 从中进行收集的进程都将获得一个 .itrace 文件。然后，通过转到“文件”>“打开”>“文件”并从“打开文件”对话框中选择 .itrace 文件，可以在 Visual Studio 中打开 .itrace 文件。有关详细信息，请参阅使用保存的 IntelliTrace 数据。