创建 .NET 对象(C#、Visual Basic、F#、C++/CLI)的自定义视图
可以在调试器变量窗口中自定义 Visual Studio 显示数据类型的方式。
特性
在 C#、Visual Basic、F# 和 C++(仅限 C++/CLI 代码)中,可以使用 DebuggerDisplayAttribute、DebuggerTypeProxyAttribute 和 DebuggerBrowsableAttribute 来添加自定义数据的扩展。
在 .NET Framework 2.0 代码中,Visual Basic 不支持 DebuggerBrowsable 特性。 此项限制在 .NET 较高版本中已经删除。
可视化工具
有两个选项可用于为 .NET 类型创建可视化工具:
- 使用 VisualStudio.Extensibility SDK:从 Visual Studio 2022 版本 17.9 开始,Visual Studio 提供了一种新的方法来创建自定义可视化工具,其提供简单的扩展安装以及面向较新版本 .NET 的功能。 此选项是推荐的 API,除非可视化工具和可视化类型应同时提供,或者需要支持 Visual Studio 的旧版本。 有关详细信息,请参阅创建 Visual Studio 调试程序可视化工具。
- 使用 Microsoft.VisualStudio.DebuggerVisualizers.DialogDebuggerVisualizer:有关此方法的详细信息,请参阅自定义可视化工具。
注意
若要为 C/C++ 对象创建可视化工具,请参阅 Natvis 文档内的 UIVisualizer 元素。 此外,请参阅 C/C++ 自定义可视化工具示例或 SQLite 本机调试器可视化工具示例。