Share via


Installare un visualizzatore

Importante

A partire da Visual Studio 2022 versione 17.9, i visualizzatori possono ora essere scritti in .NET 6.0+ che eseguono out-of-process usando il nuovo modello VisualStudio.Extensibility. Si consiglia agli autori del visualizzatore di fare riferimento alla nuova documentazione in Creare visualizzatori del debugger di Visual Studio, a meno che non vogliano supportare le versioni precedenti di Visual Studio o che vogliano spedire i visualizzatori personalizzati come parte di una DLL di libreria.

Dopo aver creato un visualizzatore, è necessario installare il visualizzatore in modo che sia disponibile in Visual Studio. Per installare un visualizzatore è sufficiente seguire una semplice procedura.

Nota

Nelle app UWP sono supportati solo i visualizzatori di testo standard, HTML, XML e JSON. Non sono supportati i visualizzatori personalizzati (creati dall'utente).

Per installare un visualizzatore per Visual Studio 2019

  1. Individuare la DLL contenente il visualizzatore compilato.

    In genere, è preferibile se sia la DLL lato debugger che la DLL sul lato debug specificano Qualsiasi CPU come piattaforma di destinazione. La DLL lato debugger deve essere qualsiasi CPU o 32 bit. La piattaforma di destinazione per la DLL sul lato debug deve corrispondere al processo di debug.

    Nota

    Il visualizzatore lato debugger viene caricato nel processo di Visual Studio, quindi deve essere una DLL di .NET Framework. Il lato debug può essere .NET Framework o .NET Standard a seconda del processo di cui viene eseguito il debug in Visual Studio.

  2. Copiare la DLL sul lato debugger (e le DLL da cui dipende) in una delle posizioni seguenti:

    • VisualStudioInstallPath\Common7\Packages\Debugger\Visualizers

    • My Documents\VisualStudioVersion\Visualizers

  3. Copiare la DLL lato debug in una delle posizioni seguenti:

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

    • My Documents\VisualStudioVersion\Visualizers\Framework

    dove Framework è:

    • net2.0 per i debug che eseguono il .NET Framework runtime.
    • netstandard2.0 per gli utenti di debug che usano un runtime che supporta netstandard 2.0 (.NET Framework v4.6.1+ o .NET Core 2.0+).
    • netcoreapp per i debug che eseguono il .NET Core runtime. (supporta .NET Core 2.0+)

    Se si vuole creare un visualizzatore autonomo, è necessaria una DLL sul lato debug. Questa DLL contiene codice per l'oggetto dati, che può implementare metodi di VisualizerObjectSource.

    Se si esegue il multitargeting del codice sul lato debug, la DLL sul lato debug deve essere inserita nella cartella per il tfm minimo supportato.

  4. Riavviare la sessione di debug.

Nota

La procedura è diversa in Visual Studio 2017 e versioni precedenti. Vedere la versione precedente di questo articolo.