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