Passo a passo: Writing a Visualizer em Visual Basic

Esta explicação passo a passo mostra como gravar um visualizador simples usando Visual Basic.O visualizador que você irá criar nesta explicação passo a passo exibe o conteúdo de uma seqüência usando uma caixa de mensagem do Windows Forms.Este visualisador simples de cadeia de caracteres é um exemplo básico para mostrar como você pode criar visualizadores para outros tipos de dados mais aplicáveis a seus projetos.

Observação
As caixas de diálogo e comandos de menu que você vê podem diferir das descritas no Help, dependendo de suas configurações ativas ou de edição.Para alterar suas configurações, vá para o Ferramentas menu e escolha de importação e exportação .Para mais informações, consulte Configurações de Visual Studio.

Código do visualisador deve ser colocado em uma DLL que será lido pelo depurador.A primeira etapa é criar um projeto de biblioteca de classes para a DLL.

Criar e preparar um projeto de biblioteca de classe

Para criar um projeto de biblioteca de classe

1. Sobre o arquivo menu, escolha nova e clique em Novo projeto.

2. No Novo projeto caixa de diálogo, em Tipo de projetos, clique em Visual Basic.

3. No modelos de , clique Biblioteca de classe.

4. No nome , digite um nome apropriado para a biblioteca de classe, como MyFirstvisualisador.

5. Clique em OK.

Quando você criou a biblioteca de classes, você deve adicionar uma referência a Debuggervisualisadors, para que você possa usar classes definidas lá.Primeiro, no entanto, você dar seu projeto um nome significativo.

Renomear Class1. vb e adicionar Microsoft.VisualStudio.Debuggervisualisadors

1. Em Solution Explorer, com o botão direito Class1. vbe no menu de atalho, clique em Renomear.

2. Altere o nome de Class1. vb para algo significativo, como DebuggerSide.vb.

   Observação
   Visual Studioa declaração de classe DebuggerSide.vb para corresponder ao nome do arquivo é alterado automaticamente.

3. Em Solution Explorer, com o botão direito Meu primeiro visualisadore no menu de atalho, clique em Adicionar referência de.

4. No Adicionar referência caixa de diálogo, no .NET , clique em Debuggervisualisadors.

5. Clique em OK.

6. No DebuggerSide.vb, adicione a seguinte instrução para o Imports instruções:

   Imports Microsoft.VisualStudio.DebuggerVisualizers
   

Adicione o código do Debugger-side

Agora, você está pronto para criar o código do lado do depurador.Este é o código que executa no depurador para exibir as informações que você deseja visualizar.Primeiro você deve alterar a declaração do DebuggerSide para que ela herda da classe base do objeto DialogDebuggerVisualizer.

Herdar de DialogDebuggerVisualizer

1. Em DebuggerSide.vb, vá para a seguinte linha de código:

   Public Class DebuggerSide
   

2. Edite o código para que ele tenha a seguinte aparência:

   Public Class DebuggerSide
   Inherits DialogDebuggerVisualizer
   

DialogDebuggerVisualizertem um método abstrato, Show, que deve substituir.

Substituir o método DialogDebuggervisualisador. show

• Em public class DebuggerSide, adicione o seguinte método:

  Protected Overrides Sub Show(ByVal windowService As Microsoft.VisualStudio.DebuggerVisualizers.IDialogVisualizerService, ByVal objectProvider As Microsoft.VisualStudio.DebuggerVisualizers.IVisualizerObjectProvider)
  
      End Sub
  

O Show método contém o código que realmente cria a caixa de diálogo visualizador ou outra interface de usuário e exibe as informações passadas para o visualisador do depurador.Você deve adicionar código que cria a caixa de diálogo e exibe as informações.Esta explicação passo a passo, você irá fazer isso usando uma caixa de mensagem do Windows Forms.Primeiro, você deve adicionar uma referência e Imports instrução para System.Windows.Forms.

Adicionar System.Windows.Forms

1. Em Solution Explorer, com o botão direito referênciase no menu de atalho, clique em Adicionar referência de.

2. No Adicionar referência caixa de diálogo, no .NET , clique em System.Windows.Forms.

3. Clique em OK.

4. Em DebuggerSide. cs, adicione a seguinte instrução para o Imports instruções:

   Imports System.Windows.Forms
   

Criar Interface de usuário do Visualizador

Agora você irá adicionar algum código para criar e mostrar a interface do usuário para seu visualisador.Porque este é seu primeiro visualisador, irá manter a interface do usuário simples e usar uma caixa de mensagem.

Mostrar a saída visualizador em uma caixa de diálogo

1. No Show método, adicione a seguinte linha de código:

   MessageBox.Show(objectProvider.GetObject().ToString())
   

   Este exemplo de código não inclui manipulação de erros.Você deve incluir o tratamento de erros em um visualisador real ou qualquer outro tipo de aplicativo.

2. Sobre o Build menu, clique em Build MyFirstVisualizer.O projeto deve compilar com êxito.Corrija quaisquer erros de compilação antes de continuar.

Adicione o atributo necessário

Que é o fim do código do debugger-side.Há mais uma etapa, no entanto: o atributo que informa o debuggee side qual coleção de classes constitui o visualisador.

Para adicionar o código debugee-lateral

1. Adicione o seguinte código de atributo para DebuggerSide.vb, após o Imports declarações, mas antes namespace MyFirstVisualizer:

   <Assembly: System.Diagnostics.DebuggerVisualizer(GetType(MyFirstVisualizer.DebuggerSide), GetType(VisualizerObjectSource), Target:=GetType(System.String), Description:="My First Visualizer")>
   

2. Sobre o Build menu, clique em Build MyFirstVisualizer.O projeto deve compilar com êxito.Corrija quaisquer erros de compilação antes de continuar.

Criar uma estrutura de teste

Neste ponto, seu primeiro visualisador é concluído.Se você tiver seguido as etapas corretamente, você pode criar o visualisador e instalá-lo em Visual Studio.Antes de instalar um visualizador em Visual Studio, no entanto, você deve testar para certificar-se de que ele seja executado corretamente.Agora você criará uma estrutura de teste para executar o visualisador sem instalá-lo em Visual Studio.

Para adicionar um método de teste para mostrar o visualisador

1. Adicione o seguinte método à classe public DebuggerSide:

   Shared Public Sub TestShowVisualizer(ByVal objectToVisualize As Object)
       Dim visualizerHost As New VisualizerDevelopmentHost(objectToVisualize, GetType(DebuggerSide))
   visualizerHost.ShowVisualizer()
   End Sub
   

2. Sobre o Build menu, clique em Build MyFirstVisualizer.O projeto deve compilar com êxito.Corrija quaisquer erros de compilação antes de continuar.

Em seguida, você deve criar um projeto executável para chamar o visualisador DLL.Para simplificar, use um projeto de aplicativo do console.

Para adicionar um projeto de aplicativo do console para a solução

1. Sobre o arquivo menu, clique em Adicionare clique em Novo projeto.

2. No Adicionar novo projeto na caixa de modelos , clique Aplicativo de Console.

3. No nome , digite um nome significativo para o aplicativo de console, como MyTestConsole.

4. Clique em OK.

Agora, você deve adicionar que o necessário referências MyTestConsole pode chamar MyFirstvisualisador.

Para adicionar referências necessárias a MyTestConsole

1. Em Solution Explorer, com o botão direito MyTestConsolee no menu de atalho, clique em Adicionar referência de.

2. No Adicionar referência caixa de diálogo, no .NET , clique em Microsoft.VisualStudio.Debuggervisualisadors.

3. Clique em OK.

4. Com o botão direito MyTestConsolee clique em Adicionar referência novamente.

5. No Adicionar referência caixa de diálogo, clique o projetos guia e selecione MyFirstvisualisador.

6. Clique em OK.

Concluir o conjunto de teste e testar o visualisador

Agora, você adicionará código para concluir o utilitário de teste.

Para adicionar código ao MyTestConsole

1. Em Solution Explorer, com o botão direito Program. vbe no menu de atalho, clique em Renomear.

2. Edite o nome de Module1. vb para algo apropriado, como TestConsole.vb.

   Observe que Visual Studio muda automaticamente a declaração da classe TestConsole.vb para corresponder ao nome do arquivo.

3. Em TestConsole.VB, adicione o seguinte Imports declaração:

   Imports MyFirstVisualizer
   

4. No método Main, adicione o seguinte código:

   Dim myString As String = "Hello, World"
   DebuggerSide.TestShowVisualizer(myString)
   

Agora você está pronto para testar seu primeiro visualisador.

Para testar o visualisador

1. Em Solution Explorer, com o botão direito MyTestConsolee no menu de atalho, clique em Set as Startup Project.

2. No menu Debug, clique em Start.

   Inicia o aplicativo de console.O Visualizador aparece e exibe a seqüência de caracteres "Hello, World".

Parabéns.Você apenas criado e testado seu primeiro visualisador.

Se você quiser usar o visualizador em Visual Studio em vez de chamá-lo apenas de equipamento de teste, você deverá instalá-lo.Para mais informações, consulte Como: instalar um visualizador.

Consulte também

Tarefas

Como: instalar um visualizador

Conceitos

Arquitetura de Visualizador

Outros recursos

Visualizadores