建立 .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 原生偵錯工具視覺化檢視範例。