Compartilhar via

Tutorial – Criar sua primeira extensão: Olá, Mundo

  • Artigo

Este exemplo do Hello World explica como criar sua primeira extensão para o Visual Studio. Este tutorial mostra como adicionar um novo comando ao Visual Studio.

No processo, você aprenderá a:

Para este exemplo, você usa o Visual C# para adicionar um botão de menu personalizado chamado "Diga Olá, Mundo!" com esta aparência:

Captura de tela mostrando um comando de menu personalizado.

Pré-requisitos

Antes de começar, verifique se você instalou a carga de trabalho de desenvolvimento de extensão do Visual Studio, que inclui o modelo VSIX e o código de exemplo.

Nota

Você pode usar qualquer edição do Visual Studio (Community, 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 "vsix" e selecione o Projeto VSIX do C# e, em seguida, Avançar.

  2. Insira "HelloWorld" como nome do projeto e selecione Criar.

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

Agora, você deve ver o projeto HelloWorld no 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 Adicionare, em seguida, Novo Item.

  3. Selecione a seção Extensibilidade e 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. Na seção de Recursos , você pode encontrar outros arquivos relacionados ao seu comando. Por exemplo, se você quiser modificar a imagem, o arquivo PNG estará 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. Ao explorar 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 o VSPackage da extensão. Nesse caso, ele é chamado 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 do 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);
  }
  ...

Salve suas alterações em cada arquivo.

Execute-o

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

Etapa 1. Pressione F5 para executar o comando Iniciar Depuração. Esse comando cria seu projeto e inicia o depurador, lançando uma nova instância do Visual Studio chamada Instância Experimental.

Etapa 2. No menu Ferramentas da Instância Experimental, clique em Diga Olá, Mundo!.

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

Você deverá ver a saída do novo comando personalizado, nesse caso, a caixa de diálogo no centro da tela que fornece a mensagem Hello World!.

Próximas etapas

Agora que você conhece as noções básicas de como trabalhar com a Extensibilidade do Visual Studio, aqui é onde você pode saber mais: