Share via

Passo a passo: Criar seu primeiro suplemento VSTO para Outlook

  • Artigo

Este passo a passo mostra como criar um suplemento VSTO para o Microsoft Office Outlook. Os recursos que você cria nesse tipo de solução estão disponíveis para o próprio aplicativo, independentemente de qual item do Outlook está aberto. Para obter mais informações, consulte Visão geral do desenvolvimento de soluções do Office (VSTO).

Aplica-se a: As informações neste tópico se aplicam a projetos de suplemento VSTO para Outlook. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Observação

Interessado em desenvolver soluções que estendam a experiência do Office em várias plataformas? Confira o novo modelo de Suplementos do Office. Os Suplementos do Office têm um espaço pequeno em comparação com os suplementos e soluções VSTO, e você pode criá-los usando praticamente qualquer tecnologia de programação da Web, como HTML5, JavaScript, CSS3 e XML.

Este passo a passo ilustra as seguintes tarefas:

  • Criando um projeto de suplemento VSTO do Outlook para Outlook.

  • Escrever código que usa o modelo de objeto do Outlook para adicionar texto ao assunto e corpo de uma nova mensagem de email.

  • Construindo e executando o projeto para testá-lo.

  • Limpando o projeto concluído para que o suplemento VSTO não seja mais executado automaticamente no computador de desenvolvimento.

    Observação

    Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizar o IDE.

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

Criar o projeto

Para criar um novo projeto do Outlook no Visual Studio

  1. Inicie o Visual Studio.

  2. No menu Arquivo , aponte para Novoe clique em Projeto.

  3. No painel de modelos, expanda Visual C# ou Visual Basic e, em seguida, expanda Office/SharePoint.

  4. No nó Office/SharePoint expandido, selecione o nó Suplementos do Office.

  5. Na lista de modelos de projeto, escolha um projeto de suplemento VSTO do Outlook.

  6. Na caixa Nome, digite FirstOutlookAddIn.

  7. Clique em OK.

    Visual Studio cria o projeto FirstOutlookAddIn e abre o arquivo de código ThisAddIn no editor.

Escrever código que adiciona texto a cada nova mensagem de email

Em seguida, adicione código ao arquivo de código ThisAddIn. O novo código usa o modelo de objeto do Outlook para adicionar texto a cada nova mensagem de email. Por padrão, o arquivo de código ThisAddIn contém o seguinte código gerado:

  • Uma definição parcial da ThisAddIn classe. Essa classe fornece um ponto de entrada para seu código e fornece acesso ao modelo de objeto do Outlook. Para obter mais informações, consulte Suplementos do programa VSTO. O restante da classe é definido em um arquivo de ThisAddIn código oculto que você não deve modificar.

  • Os ThisAddIn_Startup manipuladores de eventos e ThisAddIn_Shutdown . Esses manipuladores de eventos são chamados quando o Outlook carrega e descarrega o suplemento VSTO. Use esses manipuladores de eventos para inicializar o suplemento VSTO quando ele for carregado e para limpar os recursos usados pelo suplemento VSTO quando ele for descarregado. Para obter mais informações, consulte Eventos em projetos do Office.

Para adicionar texto ao assunto e ao corpo de cada nova mensagem de email

  1. No arquivo de código ThisAddIn, declare um campo nomeado inspectors na ThisAddIn classe. O inspectors campo mantém uma referência à coleção de janelas do Inspetor na instância atual do Outlook. Essa referência impede que o coletor de lixo libere a memória que contém o manipulador de eventos para o NewInspector evento.

    Outlook.Inspectors inspectors;

  2. Substitua o método ThisAddIn_Startup pelo seguinte código. Esse código anexa um manipulador de eventos ao NewInspector evento.

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    inspectors = this.Application.Inspectors;
    inspectors.NewInspector +=
    new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
}

  3. No arquivo de código ThisAddIn, adicione o seguinte código à ThisAddIn classe. Esse código define um manipulador de eventos para o NewInspector evento.

    Quando o usuário cria uma nova mensagem de email, esse manipulador de eventos adiciona texto à linha de assunto e ao corpo da mensagem.

    void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
{
    Outlook.MailItem mailItem = Inspector.CurrentItem as Outlook.MailItem;
    if (mailItem != null)
    {
        if (mailItem.EntryID == null)
        {
            mailItem.Subject = "This text was added by using code";
            mailItem.Body = "This text was added by using code";
        }

    }
}

    Para modificar cada nova mensagem de email, os exemplos de código anteriores usam os seguintes objetos:

  • O Application campo da ThisAddIn classe. O Application campo retorna um Application objeto, que representa a instância atual do Outlook.

  • O Inspector parâmetro do manipulador de eventos para o NewInspector evento. O Inspector parâmetro é um Inspector objeto, que representa a janela Inspetor da nova mensagem de email. Para obter mais informações, consulte Soluções do Outlook.

Testar o projeto

Ao compilar e executar o projeto, verifique se o texto aparece na linha de assunto e no corpo de uma nova mensagem de email.

Para testar o projeto

  1. Pressione F5 para compilar e executar seu projeto.

    Quando você compila o projeto, o código é compilado em um assembly que está incluído na pasta de saída de compilação para o projeto. O Visual Studio também cria um conjunto de entradas do Registro que permitem que o Outlook descubra e carregue o Suplemento VSTO e define as configurações de segurança no computador de desenvolvimento para permitir a execução do Suplemento VSTO. Para obter mais informações, consulte Visão geral do processo de compilação de solução do Office.

  2. No Outlook, crie uma nova mensagem de email.

  3. Verifique se o texto a seguir foi adicionado à linha de assunto e ao corpo da mensagem.

    Este texto foi adicionado usando código.

  4. Feche o Outlook.

Limpar o projeto

Quando terminar de desenvolver um projeto, remova o assembly do suplemento VSTO, as entradas do Registro e as configurações de segurança do computador de desenvolvimento. Caso contrário, o suplemento VSTO será executado sempre que você abrir o Outlook no computador de desenvolvimento.

Para limpar seu projeto

  1. No Visual Studio, no menu Compilar , clique em Limpar Solução.

Próximas etapas

Agora que você criou um suplemento básico do VSTO para Outlook, você pode aprender mais sobre como desenvolver suplementos do VSTO a partir destes tópicos:

  • Tarefas gerais de programação que você pode executar usando suplementos VSTO para Outlook. Para obter mais informações, consulte Suplementos do programa VSTO.

  • Usando o modelo de objeto do Outlook. Para obter mais informações, consulte Soluções do Outlook.

  • Personalizar a interface do usuário do Outlook, por exemplo, adicionando uma guia personalizada à Faixa de Opções ou criando seu próprio painel de tarefas personalizado. Para obter mais informações, consulte Personalização da interface do usuário do Office.

  • Criando e depurando suplementos VSTO para Outlook. Para obter mais informações, consulte Criar soluções do Office.

  • Implantando suplementos VSTO para Outlook. Para obter mais informações, consulte Implantar uma solução do Office.

Conteúdo relacionado