Partilhar via

Demonstra Passo a passo: Escrever um visualizador no Visual Basic

  • Artigo

Este tópico se aplica a:

Edição

Visual Basic

C#

C++

Desenvolvedores Web

Express

Padrão

PRO e equipe

Legenda de tabela:

Aplica-se

Não é aplicada

Comando ou comandos oculta por padrão.

Esta explicação passo a passo mostra como gravar um visualizador simples usando Visual Basic. O visualizador, que você criará nesta explicação passo a passo exibe o Sumário de uma seqüência de caracteres usando uma caixa de mensagem de Windows Forms.Este visualizador simples de cadeia de caracteres é um exemplo básico para mostrar como é possível 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 as configurações, vá para o Ferramentas menu e escolher Importar e exportar .Para obter mais informações, consulte Configurações do Visual Studio.

Código do visualizador 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 classes

Para criar um projeto de biblioteca de classes

  1. Sobre o Arquivo menu, escolher Novo e clicar Novo projeto.

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

  3. No Modelos clicarbiblioteca de classes.

  4. No Nome, digite um nome apropriado para o classe biblioteca, sistema autônomo MyFirstvisualisador.

  5. Clique em OK.

Quando você criar a biblioteca de classes, você deve adicionar uma referência ao Microsoft.VisualStudio.Debuggervisualisadors.dll, para que você possa usar classes definidas lá.Primeiro, no entanto, seu projeto você fornecer um nome significativo.

Renomeie Class1.vb e adicionar Microsoft.VisualStudio.Debuggervisualisadors

  1. In O gerenciador de soluções, clicar com o botão direito do mouse em Class1.vbe no menu de atalho, clique em Renomear.

  2. Altere o nome de Class1.vb para algo significativo, sistema autônomo DebuggerSide.vb.

    Observação:

    Visual Studio a declaração de classe DebuggerSide.vb para coincidir com o novo nome de arquivo é automaticamente alterado.

  3. In O gerenciador de soluções, clicar com o botão direito do mouse em Meu primeiro visualizadore no menu de atalho, clique em Adicionar referência.

  4. No Adicionar referência caixa de diálogo o NET guia, clicar Microsoft.VisualStudio.Debuggervisualisadors.dll.

  5. Clique em OK.

  6. Em DebuggerSide.vb, adicione a seguinte demonstrativo à Imports instruções:

    Imports Microsoft.VisualStudio.DebuggerVisualizers

Adicione o código do lado do depurador

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

Herdar de DialogDebuggerVisualizer

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

    Public Class DebuggerSide

  2. Edite o código para que fique assim:

    Public Class DebuggerSide
Inherits DialogDebuggerVisualizer

DialogDebuggerVisualizer tem um método abstract, Show, que você deve substituir.

Para substituir o método DialogDebuggervisualisador.show

  • In 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

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

Adicionar sistema.Windows.Forms

  1. In O gerenciador de soluções, clicar com o botão direito do mouse em Referênciase no menu de atalho, clique em Adicionar referência.

  2. No Adicionar referência caixa de diálogo o NET , clicar sistema.Windows.Forms.

  3. Clique em OK.

  4. Em DebuggerSide.cs, adicione a seguinte demonstrativo à Imports instruções:

    Imports System.Windows.Forms

Criar a interface do usuário do seu visualizador

Agora você adicionará alguns códigos para criar e mostrar a interface do usuário para seu visualizador.Como esse é seu primeiro visualizador, você irá manter a interface do usuário simples e usar uma caixa de mensagem.

  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 erro tratamento.Você deve incluir o tratamento de erro em um visualizador real ou qualquer Outros tipo de aplicativo.

  2. Sobre o Compilação menu, clicar Build MyFirstVisualizer.O projeto deve compilar com êxito.Corrija qualquer erro de compilação antes de continuar.

Adicione o atributo necessário

Que é o participante do código do lado do depurador.No entanto, há uma etapa a mais: o atributo que informa o debuggee side qual coleção de classes constitui o visualizador.

Para adicionar o código do lado do debugee

  1. Adicione o seguinte código de atributo para DebuggerSide.vb, após o Imports instruçõ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 Compilação menu, clicar Build MyFirstVisualizer.O projeto deve compilar com êxito.Corrija qualquer erro de compilação antes de continuar.

Criar uma agente de teste

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

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

  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 Compilação menu, clicar Build MyFirstVisualizer.O projeto deve compilar com êxito.Corrija qualquer erro 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 de console.

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

  1. On the Arquivo menu, clicar Adicionare, em seguida, clicar Novo projeto.

  2. No Adicionar novo projeto caixa de diálogo, no Modelos clicarAplicativo de console.

  3. No Nome, digite um nome significativo para o aplicativo de console, sistema autônomo MyTestConsole.

  4. Clique em OK.

Agora, você deve adicionar as referências necessárias para MyTestConsole poder chamar MyFirstvisualisador.

Para adicionar referências necessárias a MyTestConsole

  1. In O gerenciador de soluções, clicar com o botão direito do mouse em MyTestConsolee no menu de atalho, clique em Adicionar referência.

  2. No Adicionar referência caixa de diálogo o NET, clicar Microsoft.VisualStudio.Debuggervisualisadors.

  3. Clique em OK.

  4. clicar com o botão direito do mouse em MyTestConsolee, em seguida, clique em Adicionar referência novamente.

  5. No Adicionar referência diálogo, clicar no Projetos guia e selecionar MyFirstvisualisador.

  6. Clique em OK.

Concluir sua agente de teste e testar o visualizador

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

Para adicionar código a MyTestConsole

  1. In O gerenciador de soluções, clicar com o botão direito do mouse em programa.vbe no menu de atalho, clique em Renomear.

  2. Edite o nome de Module1.vb para algo apropriado, sistema autônomo TestConsole.vb.

    Observe que Visual Studio a declaração da classe em TestConsole.cs para coincidir com o novo nome de arquivo é automaticamente alterado.

  3. Em TestConsole.cs, adicione o seguinte Imports demonstrativo:

    Imports MyFirstVisualizer

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

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

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

Para testar o visualizador

  1. In O gerenciador de soluções, clicar com o botão direito do mouse em MyTestConsolee no menu de atalho, clique em conjunto sistema autônomo projeto de inicialização.

  2. No menu Debug, clique em Start.

    O aplicativo de console é iniciado.O visualizador aparece e exibe a seqüência de caracteres "Hello, World".

Parabéns.Você acaba de ter criado e testado seu primeiro visualisador.

Se você deseja usar seu visualizador no Visual Studio em vez de simplesmente chamá-lo do agente de teste, você precisará instalá-lo. Para obter mais informações, consulte Como: Instalar um visualizador.

Consulte também

Tarefas

Como: Instalar um visualizador

Conceitos

Arquitetura de visualizador

Outros recursos

Visualizadores