Partilhar via

Tutorial - Crie sua primeira extensão: Hello World

  • Artigo

Este exemplo do Hello World orienta você na criação de sua primeira extensão para o Visual Studio. Este tutorial mostra como adicionar um novo comando ao Visual Studio.

No processo, você aprende a:

Para este exemplo, você usa o Visual C# para adicionar um botão de menu personalizado chamado "Say Hello World!" que se parece com isto:

Captura de tela mostrando um comando de menu personalizado.

Pré-requisitos

Antes de começar, certifique-se de ter instalado a carga de trabalho de desenvolvimento de extensões do Visual Studio, , que inclui o modelo VSIX e o código de exemplo.

Observação

Você pode usar qualquer edição do Visual Studio (Comunidade, Professional ou Enterprise) para criar um projeto de extensibilidade do Visual Studio.

Criar um projeto de extensibilidade

  1. No menu Arquivo, selecione Novo>Projeto. Procure por "vsix" e selecione o projeto C# VSIX e, em seguida, Avançar.

  2. Digite "HelloWorld" para o nome do Project e selecione Criar.

Captura de tela mostrando a criação de um novo projeto VSIX.

Agora você deve ver o projeto HelloWorld em Gerenciador de Soluções.

Adicionar um comando personalizado

  1. Se você selecionar o arquivo de manifesto .vsixmanifest, poderá ver quais opções podem ser alteradas, como descrição, autor e versão.

  2. Clique com o botão direito do mouse no projeto (não na solução). No menu de contexto, selecione Adicionar e, em seguida, Novo Item.

  3. Selecione a seção Extensibilidade e, em seguida, escolha Comando.

  4. No campo Nome na parte inferior, insira um nome de arquivo como Command.cs.

Captura de tela mostrando a criação de um comando personalizado.

Seu novo arquivo de comando está visível no Gerenciador de Soluções . No nó Recursos, você pode encontrar outros arquivos relacionados ao seu comando. Por exemplo, se você deseja modificar a imagem, o arquivo PNG está aqui.

Modificar o código-fonte

Neste ponto, o comando e o texto do botão são gerados automaticamente e não tão interessantes. Você pode modificar o arquivo VSCT e o arquivo CS se quiser fazer alterações.

  • O arquivo VSCT é onde você pode renomear seus comandos e definir para onde eles vão no sistema de comandos do Visual Studio. À medida que você explora o arquivo VSCT, observe comentários que explicam o que cada seção do código VSCT controla.

  • O arquivo CS é onde você pode definir ações, como o manipulador de cliques.

  1. No Gerenciador de Soluções , localize o arquivo VSCT para sua extensão VSPackage. Neste caso, chama-se HelloWorldPackage.vsct.

  2. Altere o parâmetro ButtonText para Say Hello World!.

      ...
  <Button guid="guidCommandPackageCmdSet" id="CommandId" priority="0x0100" type="Button">
    <Parent guid="guidCommandPackageCmdSet" id="MyMenuGroup" />
    <Icon guid="guidImages" id="bmpPic1" />
    <Strings>
        <ButtonText>Say Hello World!</ButtonText>
    </Strings>
  </Button>
  ...

  3. Volte para Gerenciador de Soluções e localize o arquivo Command.cs. No método Execute, altere a cadeia de caracteres message de string.Format(..) para Hello World!.

      ...
  private void Execute(object sender, EventArgs e)
  {
    ThreadHelper.ThrowIfNotOnUIThread();
    string message = "Hello World!";
    string title = "Command";

    // Show a message box to prove we were here
    VsShellUtilities.ShowMessageBox(
        this.ServiceProvider,
        message,
        title,
        OLEMSGICON.OLEMSGICON_INFO,
        OLEMSGBUTTON.OLEMSGBUTTON_OK,
        OLEMSGDEFBUTTON.OLEMSGDEFBUTTON_FIRST);
  }
  ...

Certifique-se de salvar suas alterações em cada arquivo.

Executá-lo

Agora você pode executar o código-fonte na instância experimental do Visual Studio.

Passo 1. Pressione F5 para executar o comando Start Debugging. Este comando compila o projecto e arranca o depurador, lançando uma nova instância do Visual Studio chamada Instância Experimental.

Passo 2. No menu Ferramentas do de Instância Experimental, clique em Diga Olá Mundo!.

Captura de tela mostrando que o comando personalizado exibe uma caixa de mensagem.

Você deve ver a saída do seu novo comando personalizado, neste caso, a caixa de diálogo no centro da tela que lhe dá a mensagem "Hello World!".

Próximos passos

Agora que você já sabe o básico de como trabalhar com a Extensibilidade do Visual Studio, aqui está onde você pode saber mais: