Поделиться через


Создание пользовательских представлений объектов .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:

  • Использование пакета SDK для VisualStudio.Extensibility: Начиная с Visual Studio 2022 версии 17.9, Visual Studio предлагает новый способ создания пользовательских визуализаторов, которые обеспечивают, помимо прочего, простоту установки расширений и возможность нацеливаться на более новые версии .NET. Этот параметр является рекомендуемым API, за исключением случаев, когда визуализатор и визуализированный тип должны отправляться вместе или в случаях, когда требуется поддерживать более раннюю версию Visual Studio. Дополнительные сведения см. в статье Создание визуализаторов отладчика Visual Studio.
  • Использование Microsoft.VisualStudio.DebuggerVisualizers.DialogDebuggerVisualizer: Дополнительную информацию об этом подходе см. в разделе Пользовательские визуализаторы.

Заметка

Чтобы создать визуализатор для объектов C/C++, обратитесь к элементу UIVisualizer в документации Natvis. Кроме того, см. пример пользовательского визуализатора C/C++ или образец визуализатора отладчика SQLite Native.