语言

安装 Visualizer

Important

从 Visual Studio 2022 版本 17.9 开始,可视化工具现在可以使用新的 VisualStudio.Extensibility 模型以 .NET 6.0+ 编写,以进程外运行。 有关使用新模型创建的扩展,请参阅 创建 Visual Studio 调试器可视化工具中的文档。 如果需要支持较旧版本的 Visual Studio,或者想要将自定义可视化工具作为库 DLL 的一部分交付,请使用本文中的信息,该信息仅适用于较旧的扩展开发模型(VSSDK)。

创建可视化工具后,必须安装可视化工具,使其在Visual Studio中可用。 安装可视化工具是一个简单的过程。

Note

在 UWP 应用中,仅支持标准文本、HTML、XML 和 JSON 查看器。 不支持自定义(用户创建的)可视化工具。

安装适用于 Visual Studio 2019 的可视化工具

  1. 找到包含你构建的可视化工具的 DLL。

    通常,如果调试器端 DLL 和被调试端 DLL 都指定 Any CPU 作为目标平台,则最好。 调试器端 DLL 必须是 Any CPU 或 32 位。 调试对象端 DLL 的目标平台应与调试对象进程相对应。

    Note

    调试器端可视化工具在Visual Studio进程中加载,因此它必须是.NET框架 DLL。 调试对象端可以是 .NET Framework 或 .NET Standard,具体取决于在Visual Studio中调试的进程。

  2. 将 调试器端 DLL(及其依赖的任何 DLL)复制到以下任一位置:

    • VisualStudioInstallPath\Common7\Packages\Debugger\Visualizers

    • My Documents\ VisualStudioVersion\Visualizers

  3. 将 调试对象端 DLL 复制到以下任一位置:

    • VisualStudioInstallPath\Common7\Packages\Debugger\Visualizers\框架

    • My Documents\ VisualStudioVersion\Visualizers\框架

    其中 框架 为以下任一:

    • net2.0 用于运行 .NET Framework 运行时的被调试程序。
    • 对于使用支持 netstandard 2.0(.NET Framework v4.6.1+ 或 .NET Core 2.0+)的运行时的调试对象,为 netstandard2.0。
    • netcoreapp 用于运行 .NET Core 运行时的被调试程序。 (支持 .NET Core 2.0+)

    如果要创建独立的可视化工具,则需要被调试端 DLL。 此 DLL 包含数据对象的代码,该代码可实现 VisualizerObjectSource 方法。

    如果要对调试对象端代码进行多目标处理,则必须将调试对象端 DLL 放入最低受支持 TFM 对应的文件夹中。

  4. 重启调试会话。

Note

此过程在 Visual Studio 2017 及更早版本中有所不同。 请参阅本文的先前版本。