Freigeben über


Installieren einer Schnellansicht

Wichtig

Ab Visual Studio 2022 Version 17.9 können jetzt Visualizer in .NET 6.0+ geschrieben werden, die außerhalb des Prozesses unter Verwendung des neuen VisualStudio.Extensibility-Modells laufen. Wir empfehlen Visualizer-Autoren, die neue Dokumentation unter Visual Studio Debugger Visualizer erstellen zu referenzieren, es sei denn, sie möchten ältere Versionen von Visual Studio unterstützen oder ihre benutzerdefinierten Visualisierungen als Teil einer Bibliotheks-DLL ausliefern.

Nachdem Sie eine Schnellansicht erstellt haben, müssen Sie die Schnellansicht installieren, sodass sie in Visual Studio zur Verfügung steht. Das Installieren einer Schnellansicht ist einfach.

Hinweis

In UWP-Apps werden nur die Schnellansichten Standardtext, HTML, XML und JSON unterstützt. Benutzerdefinierte (von Benutzern erstellte) Schnellansichten werden nicht unterstützt.

Installieren einer Schnellansicht für Visual Studio 2019

  1. Suchen Sie die DLL, die die erstellte Schnellansicht enthält.

    In der Regel ist es am besten, wenn sowohl für die debuggerseitige DLL als auch für die zu debuggende DLL Beliebige CPU als Zielplattform angegeben ist. Für die debuggerseitige DLL muss entweder Beliebige CPU oder 32-Bit ausgewählt sein. Die Zielplattform für die zu debuggende DLL sollte dem Prozess für zu debuggende Komponenten entsprechen.

    Hinweis

    Die debuggerseitige Schnellansicht wird in den Visual Studio-Prozess geladen, sodass es sich um eine .NET Framework-DLL handeln muss. Auf der zu debuggenden Seite kann entweder .NET Framework oder .NET Standard vorhanden sein, je nachdem, welcher Prozess in Visual Studio gedebuggt wird.

  2. Kopieren Sie die debuggerseitige DLL (und alle davon abgängigen DLLs) an einen der folgenden Speicherorte:

    • VisualStudioInstallPath \Common7\Packages\Debugger\Visualizers

    • My Documents\ VisualStudioVersion \Visualizers

  3. Kopieren Sie die zu debuggende DLL an einen der folgenden Speicherorte:

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

    • My Documents\ VisualStudioVersion \Visualizers\ Framework

    Framework kann hier Folgendes sein:

    • net2.0 für zu debuggende Komponenten, die die .NET Framework-Runtime ausführen
    • netstandard2.0 für zu debuggende Komponenten, die eine Runtime verwenden, die netstandard 2.0 unterstützt (.NET Framework v4.6.1+ oder .NET Core 2.0+)
    • netcoreapp für zu debuggende Komponenten, die die .NET Core-Runtime ausführen (Unterstützung für .NET Core 2.0+)

    Eine zu debuggende DLL ist erforderlich, wenn Sie eine eigenständige Schnellansicht erstellen möchten. Diese DLL enthält Code für das Datenobjekt, das Methoden von VisualizerObjectSource implementieren kann.

    Wenn Sie den zu debuggenden Code mehrfach anvisieren, muss die zu debuggende DLL im Ordner für den minimal unterstützten Zielframeworkmoniker (TFM) abgelegt werden.

  4. Starten Sie die Debugsitzung neu.

Hinweis

Das Verfahren unterscheidet sich in Visual Studio 2017 und älteren Versionen. Lesen Sie die vorherige Version dieses Artikels.