Udostępnij za pomocą


Instalowanie wizualizatora

Ważne

Począwszy od Visual Studio 2022 w wersji 17.9, wizualizatory można teraz pisać na platformie .NET 6.0+, które działają poza procesem przy użyciu nowego modelu VisualStudio.Extensibility. Aby uzyskać rozszerzenia utworzone przy użyciu nowego modelu, zobacz dokumentację w temacie Tworzenie wizualizatorów debugera programu Visual Studio . Jeśli potrzebujesz obsługiwać starsze wersje programu Visual Studio lub chcesz dostarczyć niestandardowe wizualizatory w ramach biblioteki DLL, skorzystaj z informacji w tym artykule, które dotyczą tylko starszego modelu programowania rozszerzeń (VSSDK).

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

Uwaga / Notatka

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ć Any CPU lub 32-bitowa. Platforma docelowa biblioteki DLL po stronie debugowania powinna odpowiadać procesowi debuggee.

    Uwaga / Notatka

    Wizualizator po stronie debugera jest ładowany w procesie programu Visual Studio, więc musi to być biblioteka DLL programu .NET Framework. Po stronie debugowanego procesu może być stosowany .NET Framework lub .NET Standard w zależności od tego, który 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 Framework jest jednym z następujących:

    • net2.0 na potrzeby debugowania z uruchomionym środowiskiem uruchomieniowym .NET Framework .
    • netstandard2.0 do aplikacji debugowanych 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 / Notatka

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