Установка визуализатора

  • Статья

Внимание

Начиная с Visual Studio 2022 версии 17.9 визуализаторы теперь могут быть написаны в .NET 6.0+ с использованием новой модели VisualStudio.Extensibility. Мы рекомендуем авторам визуализаторов ссылаться на новую документацию по созданию визуализаторов отладчика Visual Studio, если они не хотят поддерживать более старые версии Visual Studio или не хотите отправлять пользовательские визуализаторы в составе библиотеки DLL.

После создания визуализатора необходимо установить его так, чтобы он стал доступен в Visual Studio. Установка визуализатора — это простой процесс.

Примечание.

В приложениях UWP поддерживаются только стандартные текстовые визуализаторы, а также визуализаторы HTML, XML и JSON. Пользовательские визуализаторы (то есть, созданные пользователем) не поддерживаются.

Установка визуализатора для Visual Studio 2019

  1. Найдите библиотеку DLL, содержащую построенный визуализатор.

    Как правило, лучше всего, если DLL-библиотека на стороне отладчика и библиотека DLL отлаживаемой стороны указывают любой ЦП в качестве целевой платформы. DLL-библиотека на стороне отладчика должна быть либо любым ЦП, либо 32-битным. Целевая платформа для библиотеки DLL на стороне отлаживаемого объекта должна соответствовать процессу отладки.

    Примечание.

    Визуализатор на стороне отладчика загружается в процесс Visual Studio, поэтому это должна быть библиотека DLL платформы .NET Framework. В качестве стороны отладчика может выступать как .NET Framework, так и .NET Standard, в зависимости от того, отладка какого процесса выполняется в Visual Studio.

  2. Скопируйте DLL стороны отлаживаемого объекта (и все библиотеки DLL, от которых она зависит) в одно из следующих расположений:

    • VisualStudioInstallPath\Common7\Packages\Debugger\Visualizers

    • My Documents\ VisualStudioVersion \Visualizers

  3. Скопируйте DLL стороны отлаживаемого объекта в одно из следующих расположений:

    • VisualStudioInstallPath\Common7\Packages\Debugger\Visualizers\ Framework

    • My Documents\ VisualStudioVersion \Visualizers\ Framework

    где Framework является одним из следующих:

    • net2.0 для отлаживаемого объекта, выполняющего среду выполнения .NET Framework.
    • netstandard2.0 для отлаживаемого объекта с использованием среды выполнения, поддерживающей netstandard 2.0 (.NET Framework v4.6.1+ или .NET Core 2.0+).
    • netcoreapp для отлаживаемого объекта, выполняющего среду выполнения .NET Core. (поддерживает .NET Core 2.0+)

    Библиотека DLL на стороне отлаживаемого объекта необходима, если требуется создать автономный визуализатор. Эта библиотека DLL содержит код для объекта данных, который может реализовывать методы VisualizerObjectSource.

    Если вы отлаживаете различные типы кода на стороне отлаживаемого объекта, его библиотека DLL должна быть помещена в папку для минимально поддерживаемых TFM.

  4. Перезапустите сеанс отладки.

Примечание.

Процедура отличается в Visual Studio 2017 и более ранних версиях. См. предыдущую версию этой статьи.

Связанный контент