Microsoft.VisualStudio.DebuggerVisualizers Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Classi
DialogDebuggerVisualizer |
Tutti i visualizzatori del debugger personalizzati devono derivare da questa classe e fornire un costruttore senza parametri da chiamare da VS. |
VisualizerDevelopmentHost |
Classe host per il test durante lo sviluppo del visualizzatore personalizzato gestito. |
VisualizerObjectSource |
Fornisce l'accesso all'oggetto visualizzato. |
VisualizerObjectSourceException |
Rappresenta un'eccezione generata dal lato debug, tramite EE, l'infrastruttura del visualizzatore (host di debug) o il codice utente di debug e viene generata sul lato interfaccia utente (rilevabile dall'oggetto DialogDebuggerVisualizer). È un equivalente dell'interfaccia utente approssimativa di Microsoft.VisualStudio.VIL.VisualStudioHost.DebugeVisualizerException. |
Interfacce
IAsyncVisualizerObjectProvider |
Fornisce un'implementazione asincrona per i metodi definiti in IVisualizerObjectProvider2 che forniscono funzionalità per passare i dati dall'oggetto debug al visualizzatore e viceversa. |
IDeserializableObject |
Interfaccia usata per deserializzare gli oggetti quando il formato sottostante (binario o JSON) non è noto. |
IDialogVisualizerService |
Fornisce metodi che un visualizzatore può chiamare per visualizzare System.Windows Forms, dialoghi e controlli. |
IVisualizerObjectProvider |
Fornisce i dati dell'oggetto dal debug al visualizzatore. |
IVisualizerObjectProvider2 |
Fornisce funzionalità aggiuntive per passare i dati dal debug al visualizzatore. |
IVisualizerObjectProvider3 |
Consente al debugger del visualizzatore e alle coordinate dei componenti lato debug su cui usare il meccanismo di serializzazione e fornisce funzionalità aggiuntive per passare i dati al lato debug tenendo conto dell'oggetto SelectedFormatterPolicy. |
Enumerazioni
FormatterPolicy |
Stile di formattazione da usare durante la serializzazione/deserializzazione delle informazioni da VisualizerObjectSource. |
Esempio
public class DebuggerSide : DialogDebuggerVisualizer
{
override protected void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)
{
MessageBox.Show(objectProvider.GetObject().ToString());
}
// . . . Other methods omitted for clarity.
}
Commenti
Un visualizzatore è un piccolo programma usato dal debugger di Visual Studio per visualizzare, ovvero visualizzare, un oggetto di un tipo di dati specifico in modo significativo. Per visualizzare un oggetto, un visualizzatore usa il codice eseguito nel processo del debugger (lato debugger) e il codice nel processo in fase di debug (lato debug).
Il lato debugger e il lato debug comunicano tra loro usando VisualizerObjectSource e IVisualizerObjectProvider.
Il lato debug usa VisualizerObjectSource per specificare un VisualizerObjectSource oggetto per il lato debugger. Il debugger richiede e riceve queste informazioni chiamando i metodi nell'interfaccia IVisualizerObjectProvider .
Un visualizzatore può modificare, nonché visualizzare i dati. Se il visualizzatore supporta la modifica dei dati, è necessario sostituire completamente i dati chiamando ReplaceData o ReplaceObject trasferiscendo i dati al debug usando TransferData o TransferObject. Se si desidera salvare nuovamente i dati, è anche necessario creare un'origine oggetto personalizzata.