创建自定义 .NET 对象的视图(C#、Visual Basic、F#、C++/CLI)

可以在调试器变量窗口中自定义 Visual Studio 显示数据类型的方式。

属性

在 C#、Visual Basic、F# 和 C++(仅限 C++/CLI 代码)中,可以使用 DebuggerDisplayAttributeDebuggerTypeProxyAttributeDebuggerBrowsableAttribute为自定义数据添加扩展。

在 .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 本机调试器可视化工具 示例。