Instalowanie wizualizatora

Ważne

Począwszy od programu Visual Studio 2022 w wersji 17.9, wizualizatory można teraz pisać na platformie .NET 6.0+, które wybiegają poza proces przy użyciu nowego modelu rozszerzenia VisualStudio.Extensibility. Zachęcamy autorów wizualizatorów do odwołania się do nowej dokumentacji w sekcji Tworzenie wizualizatorów debugera programu Visual Studio, chyba że chcą obsługiwać starsze wersje programu Visual Studio lub chcą dostarczać niestandardowe wizualizatory w ramach biblioteki DLL.

Po utworzeniu wizualizatora należy zainstalować wizualizator, aby był dostępny w programie Visual Studio. Instalowanie wizualizatora jest prostym procesem.

Uwaga

W aplikacjach platformy UWP obsługiwane są tylko standardowe elementy tekstowe, HTML, XML i JSON. Niestandardowe (utworzone przez użytkownika) wizualizatory nie są obsługiwane.

Aby zainstalować wizualizator dla programu Visual Studio 2019

  1. Znajdź bibliotekę DLL zawierającą utworzony wizualizator.

    Zazwyczaj najlepiej jest, jeśli zarówno biblioteka DLL po stronie debugera, jak i biblioteka DLL po stronie debugowania określają dowolny procesor CPU jako platformę docelową. Biblioteka DLL po stronie debugera musi być dowolna lub 32-bitowa. Platforma docelowa biblioteki DLL po stronie debugowania powinna odpowiadać procesowi debuggee.

    Uwaga

    Wizualizator po stronie debugera jest ładowany w procesie programu Visual Studio, więc musi to być biblioteka DLL programu .NET Framework. Debuggee po stronie może być .NET Framework lub .NET Standard w zależności od tego, jaki proces jest debugowany w programie Visual Studio.

  2. Skopiuj bibliotekę DLL po stronie debugera (i wszystkie biblioteki DLL, od których zależy) do jednej z następujących lokalizacji:

    • VisualStudioInstallPath\Common7\Packages\Debugger\Visualizers

    • My Documents\Visualstudioversion\Visualizers

  3. Skopiuj bibliotekę DLL po stronie debugowania do jednej z następujących lokalizacji:

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

    • My Documents\VisualStudioVersion\Visualizers\Framework

    gdzie struktura to:

    • net2.0 na potrzeby debugowania z uruchomionym środowiskiem uruchomieniowym .NET Framework .
    • netstandard2.0 do debugowania przy użyciu środowiska uruchomieniowego obsługującego netstandard 2.0 (.NET Framework v4.6.1+ lub .NET Core 2.0+).
    • netcoreapp na potrzeby debugowania z uruchomionym środowiskiem uruchomieniowym .NET Core . (obsługuje ).NET Core 2.0+

    Biblioteka DLL po stronie debugowania jest niezbędna, jeśli chcesz utworzyć autonomiczny wizualizator. Ta biblioteka DLL zawiera kod obiektu danych, który może implementować metody VisualizerObjectSource.

    Jeśli kod po stronie debugowania jest wielowersyjny, biblioteka DLL po stronie debugowania musi zostać umieszczona w folderze dla co najmniej obsługiwanego programu TFM.

  4. Uruchom ponownie sesję debugowania.

Uwaga

Procedura różni się w programie Visual Studio 2017 i starszych. Zobacz poprzednią wersję tego artykułu.