Microsoft.VisualStudio.DebuggerVisualizers Namespace
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Classes
DialogDebuggerVisualizer |
Todos os Visualizadores de Depuradores personalizados devem derivar dessa classe e fornecer um construtor sem parâmetros a ser chamado pelo VS. |
VisualizerDevelopmentHost |
Classe de host para teste durante o desenvolvimento do visualizador personalizado gerenciado. |
VisualizerObjectSource |
Fornece acesso ao objeto que está sendo visualizado. |
VisualizerObjectSourceException |
Representa uma exceção gerada do lado de depuração – por meio do EE, da infraestrutura do visualizador (host de depuração) ou do debuggee user-code e é gerada no lado da interface do usuário (que pode ser capturada do DialogDebuggerVisualizer). É um equivalente de interface do usuário aproximada de Microsoft.VisualStudio.VIL.VisualStudioHost.DebuggeeVisualizerException. |
Interfaces
IAsyncVisualizerObjectProvider |
Fornece uma implementação assíncrona para os métodos definidos em IVisualizerObjectProvider2 que fornecem funcionalidade para passar dados do depurador para o visualizador e vice-versa. |
IDeserializableObject |
Interface usada para desserializar objetos quando o formato subjacente (binário ou JSON) não é conhecido. |
IDialogVisualizerService |
Fornece métodos que um visualizador pode chamar para exibir formulários, caixas de diálogo e controles system.Windows. |
IVisualizerObjectProvider |
Fornece dados de objeto do depurador para o visualizador. |
IVisualizerObjectProvider2 |
Fornece funcionalidade adicional para passar dados do depurador para o visualizador. |
IVisualizerObjectProvider3 |
Permite que os componentes do lado do depurador e do depurador coordenem em qual mecanismo de serialização usar e fornece funcionalidade adicional para passar dados para o lado de depuração levando em conta o SelectedFormatterPolicy. |
Enumerações
FormatterPolicy |
O estilo de formatação a ser usado ao serializar/desserializar informações do VisualizerObjectSource. |
Exemplos
public class DebuggerSide : DialogDebuggerVisualizer
{
override protected void Show(IDialogVisualizerService windowService, IVisualizerObjectProvider objectProvider)
{
MessageBox.Show(objectProvider.GetObject().ToString());
}
// . . . Other methods omitted for clarity.
}
Comentários
Um visualizador é um pequeno programa que o depurador do Visual Studio usa para exibir, ou seja, visualizar, um objeto de um tipo de dados específico de forma significativa. Para visualizar um objeto, um visualizador usa código que é executado no processo do depurador (o lado do depurador) e o código no processo que está sendo depurado (o lado do depurador).
O lado do depurador e o lado de depurador se comunicam entre si usando VisualizerObjectSource e IVisualizerObjectProvider.
O lado de depuração usa VisualizerObjectSource para especificar um VisualizerObjectSource objeto para o lado do depurador. O lado do depurador solicita e recebe essas informações chamando métodos na IVisualizerObjectProvider interface.
Um visualizador pode editar, bem como exibir, dados. Se o visualizador der suporte à edição de dados, você deverá substituir os dados inteiramente chamando ReplaceData ou ReplaceObject ou transferindo dados de volta para o depurador usando TransferData ou TransferObject. Se você quiser salvar dados de volta, também precisará criar sua própria fonte de objeto.