.NET オブジェクトのカスタム ビューを作成する (C#、Visual Basic、F#、C++/CLI)

Visual Studio でデバッガーの変数ウィンドウにデータ型を表示する方法をカスタマイズできます。

属性

C#、Visual Basic、F#、および C++ (C++/CLI コードのみ) では、DebuggerDisplayAttributeDebuggerTypeProxyAttribute、および DebuggerBrowsableAttribute を使用して、カスタム データの展開を追加できます。

.NET Framework 2.0 コードでは、Visual Basic は DebuggerBrowsable 属性をサポートしていません。 この制限は、.NET の新しいバージョンで解除されています。

ビジュアライザー

.NET タイプのビジュアライザーを作成するには、次の 2 つのオプションがあります。

  • VisualStudio.Extensibility SDK の使用: 中でも Visual Studio 2022 バージョン 17.9 以降の Visual Studio には、簡単に行える拡張機能のインストール、新しいバージョンの .NET を対象とする機能を提供するカスタム ビジュアライザーを作成する新しい方法が用意されています。 このオプションは、ビジュアライザーと視覚化されたタイプが一緒に提供される必要がある場合や、以前のバージョンの Visual Studio をサポートする必要がある場合を除き、推奨される API です。 詳細については、「Visual Studio デバッガー ビジュアライザーの作成」を参照してください。
  • Microsoft.VisualStudio.DebuggerVisualizers.DialogDebuggerVisualizer の使用: この方法の詳細については、「カスタム ビジュアライザー」を参照してください。

Note

C/C++ オブジェクトのビジュアライザーを作成するには、Natvis のドキュメント内の UIVisualizer 要素に関するセクションを参照してください。 また、C/C++ カスタム ビジュアライザーのサンプル、または SQLite ネイティブ デバッガー ビジュアライザーのサンプルもご覧ください。