安装可视化工具
重要
从 Visual Studio 2022 版本 17.9 开始,可视化工具现在可以使用 .NET 6.0+ 编写,其使用新的 VisualStudio.Extensibility 模型在进程外运行。 我们鼓励可视化工具作者参考创建 Visual Studio 调试程序可视化工具处的新文档,除非他们希望支持旧版 Visual Studio,或者希望将其自定义可视化工具作为库 DLL 的一部分交付。
创建可视化工具后,还必须安装该可视化工具,这样才可在 Visual Studio 中使用它。 安装可视化工具是个简单的过程。
注意
UWP 应用仅支持标准文本、HTML、XML 和 JSON 可视化工具。 不支持自定义(用户创建的)可视化工具。
安装适用于 Visual Studio 2019 的可视化工具
找到包含已创建的可视化工具的 DLL。
通常,最理想的情况是调试器端 DLL 和调试对象端 DLL 指定任意 CPU 作为目标平台。 调试器端 DLL 必须为“任意 CPU”或“32 位” 。 调试对象端 DLL 的目标平台应对应于调试对象进程。
注意
调试器端可视化工具会加载到 Visual Studio 进程中,因此必须是 .NET Framework DLL。 调试对象端可以是 .NET Framework 也可以是 .NET Standard,具体取决于 Visual Studio 中正在调试的进程。
将调试器端 DLL(以及它所依赖的任意 DLL)复制到以下位置之一:
VisualStudioInstallPath
\Common7\Packages\Debugger\Visualizers
My Documents\
VisualStudioVersion\Visualizers
将调试对象端 DLL 复制到下列位置之一:
VisualStudioInstallPath
\Common7\Packages\Debugger\Visualizers\
FrameworkMy Documents\
VisualStudioVersion\Visualizers\
Framework
其中 Framework:
- 对于运行
.NET Framework
运行时的调试对象,为net2.0
。 - 对于使用支持
netstandard 2.0
(.NET Framework v4.6.1+
或.NET Core 2.0+
)的运行时的调试对象,为netstandard2.0
。 - 对于运行
.NET Core
运行时的调试对象,为netcoreapp
。 (支持.NET Core 2.0+
)
如果要创建独立可视化工具,则需要调试对象端 DLL。 此 DLL 包含数据对象的代码,该代码可实现 VisualizerObjectSource 方法。
如果你对调试对象端代码设定了多个目标,则必须将调试对象端 DLL 置于最小支持 TFM 的文件夹中。
重新启动调试会话。
注意
此过程在 Visual Studio 2017 及更早版本中是不同的。 请参阅本文的早期版本。