Como escrever um visualizador
Você pode escrever um visualizador personalizado para um objeto de qualquer classe gerenciada com exceção de Object ou Array.
Dica
Nos aplicativos do Store, somente os visualizadores do texto padrão HTML, XML e JSON são suportados.Não há suporte para visualizadores personalizados (criados pelo usuário).
A arquitetura de um visualizador de depurador tem duas partes:
O lado do depurador é executado no depurador do Visual Studio. O código do lado depurador cria e exibe a interface do usuário para o visualizador.
O lado a ser depurado é executado dentro do processo que o Visual Studio está depurando (o lado a ser depurado).
O objeto de dados que você deseja visualizar (um objeto String, por exemplo) existe no processo a ser depurado. Assim, o lado a ser depurado precisa enviar esse objeto de dados para o lado do depurador, que pode então exibi-lo usando uma interface de usuário que você cria.
O lado do depurador recebe esse objeto de dados a ser visualizado de um provedor de objeto que implementa a interface IVisualizerObjectProvider. O lado a ser depurado envia o objeto de dados pela origem do objeto, que é derivada de VisualizerObjectSource. O provedor do objeto também pode enviar dados de volta para a origem do objeto, que permite escrever um visualizador que edita, além de exibir, dados. O provedor do objeto pode ser substituído para se comunicar com o avaliador de expressão e, consequentemente, com a origem do objeto
O lado a ser depurado e o lado do depurador comunicam-se por meio do Stream. Os métodos são fornecidos para serializar um objeto de dados em um Stream e desserializar o Stream de volta para um objeto de dados.
O código do lado a ser depurado é especificado usando o atributo DebuggerVisualizer (DebuggerVisualizerAttribute).
Para criar a interface do usuário do visualizador no lado do depurador, você deverá criar uma classe que herda de DialogDebuggerVisualizer e substitui o método DialogDebuggerVisualizer.Show para exibir a interface.
Você pode usar IDialogVisualizerService para exibir formulários, caixas de diálogo e os controles do Windows a partir do visualizador.
O suporte para tipos genéricos é limitado. Você poderá escrever um visualizador para um destino que é um tipo genérico somente se o tipo genérico for um tipo aberto. Essa restrição é a mesma que a restrição ao usar o atributo DebuggerTypeProxy. Para obter detalhes, consulte Usando o atributo DebuggerTypeProxy.
Os visualizadores personalizados podem ter considerações de segurança. Consulte Considerações de segurança do visualizador.
Os procedimentos a seguir dão uma exibição de alto nível do que você precisa fazer para criar um visualizador. Para obter uma explicação mais detalhada, consulte Instruções passo a passo: escrevendo um visualizador em C#.
Para criar o lado do depurador
Use os métodos IVisualizerObjectProvider para obter o objeto visualizado no lado do depurador.
Crie uma classe que herda de DialogDebuggerVisualizer.
Substitua o método DialogDebuggerVisualizer.Show para exibir sua interface. Use os métodos IDialogVisualizerService para exibir os formulários, as caixas de diálogo e os controles do Windows como parte da interface.
Aplique DebuggerVisualizerAttribute, permitindo que você tenha um visualizador (DialogDebuggerVisualizer).
Para criar o lado a ser depurado
Aplique DebuggerVisualizerAttribute, permitindo que você tenha um visualizador (DialogDebuggerVisualizer) e uma origem do objeto (VisualizerObjectSource). Se você omitir a origem do objeto, uma fonte do objeto padrão será usada
Se você quiser que o visualizador edite objetos de dados, bem como exibi-los, precisará substituir os métodos TransferData ou CreateReplacementObject do VisualizerObjectSource.
Consulte também
Tarefas
Como testar e depurar um visualizador
Conceitos
Considerações de segurança do visualizador