Demonstra Passo a passo: Criando o primeiro nível do aplicativo Add-in para Outlook

Artigo
08/08/2011

Esta explicação passo a passo mostra como criar um suplemento em nível de aplicativo para o de Microsoft Office Outlook. Os recursos que você criar nesse tipo de solução estão disponíveis para o aplicativo propriamente dito, independentemente de qual item do Outlook é aberto. For more information, see Visão geral de desenvolvimento de soluções do Office.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Outlook 2007 e Outlook 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

This walkthrough illustrates the following tasks:

Criando um projeto de suplemento do Outlook para o Outlook.
Escrever o código que usa o modelo de objeto do Outlook para adicionar o texto para o assunto e corpo de uma nova mensagem de email.
A criação e execução do projeto para testá-lo.
Limpando o projeto concluído para que o suplemento não executa mais automaticamente no computador de desenvolvimento.

Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da 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, consulte Configurações do Visual Studio.

Pré-requisitos

You need the following components to complete this walkthrough:

Uma edição do Visual Studio 2010 que inclua as ferramentas de desenvolvedor do Microsoft Office. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.100\).md).

Microsoft Office Outlook 2007 ou Outlook 2010.

Creating the Project

Para criar um novo projeto do Outlook em Visual Studio

Start Visual Studio.
On the File menu, point to New, and then click Project.
No painel templates, expanda Visual C# ou Visual Basice em seguida, expanda Office.
Em expandida Office nó, selecione o 2007 se você tiver o Outlook 2007 instalado, ou selecione o 2010 o nó se você tiver Outlook 2010 instalado.
Na lista de modelos de projeto, selecione suplemento do Outlook 2007 ou suplemento do Microsoft Outlook 2010.
No nome , digite FirstOutlookAddIn.
Click OK.

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

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

Em seguida, adicione o código para o 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 o seu código e fornece acesso ao modelo de objeto do Outlook. For more information, see Os suplementos de nível de aplicativo de programação.. O restante do ThisAddIn classe é definida em um arquivo de código oculto que você não deve modificar.
O ThisAddIn_Startup e ThisAddIn_Shutdown manipuladores de evento. Esses manipuladores de eventos são chamados quando o Outlook carrega e descarrega o suplemento. Use esses manipuladores de evento para inicializar seu suplemento quando ele for carregado e limpar os recursos usados por seu suplemento, quando ela é descarregada. For more information, see Eventos em projetos do Office.

Para adicionar o texto para o assunto e corpo de cada nova mensagem de email

No arquivo de código ThisAddIn, declare um campo chamado inspectors na ThisAddIn classe. O inspectors campo mantém uma referência à coleção de janelas do Inspetor de propriedades na instância atual do Outlook. Esta referência impede que o coletor de lixo liberar a memória que contém o manipulador de eventos para o NewInspector de evento.
```
Private WithEvents inspectors As Outlook.Inspectors
```
```
Outlook.Inspectors inspectors;
```

Substituir o ThisAddIn_Startup método com o código a seguir. Esse código anexa um manipulador de eventos para o NewInspector de evento.

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    inspectors = Me.Application.Inspectors
End Sub

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

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

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

Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
    Dim mailItem As Outlook.MailItem = CType(Inspector.CurrentItem, Outlook.MailItem)
    If Not (mailItem Is Nothing) Then
        If mailItem.EntryID Is Nothing Then
            mailItem.Subject = "This text was added by using code"
            mailItem.Body = "This text was added by using code"
        End If
    End If
End Sub

void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
{
    Outlook.MailItem mailItem = (Outlook.MailItem)Inspector.CurrentItem;
    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 a cada nova mensagem de email, os exemplos de código anterior usam os seguintes objetos:

O Application campo de ThisAddIn classe. O Application campo retorna um Application o objeto, que representa a instância atual do Outlook.
O Inspector parâmetro do manipulador de eventos para o NewInspector de evento. O Inspector parâmetro é um Inspector o objeto, que representa a janela do Inspetor de nova mensagem de email. For more information, see Soluções do Outlook.

Testing the Project

Quando você compilar e executa o projeto, verifique se o texto aparece na linha de assunto e corpo de uma nova mensagem de email.

Para testar o projeto.

Pressione F5 para criar e executar seu projeto.

Quando você constrói o projeto, o código é compilado em um assembly que está incluído na pasta de saída de compilação do projeto. Visual Studio também cria um conjunto de entradas de registro para ativar o Outlook para descobrir e carregar o suplemento, e ele define as configurações de segurança no computador de desenvolvimento para ativar o add-in executar. For more information, see Visão Geral do Processo de Compilação de uma Solução Office.
No Outlook, crie uma nova mensagem de email.
Verifique se o seguinte texto é adicionado para a linha de assunto e o corpo da mensagem.

Este texto foi adicionado por meio de código.
Feche o Outlook.

Limpando o projeto.

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

Para limpar o seu projeto.

Em Visual Studio, sobre o Build menu, clique em Limpar solução.

Próximas etapas

Agora que você criou um suplemento do nível de aplicativo básico para o Outlook, você pode aprender mais sobre como desenvolver suplementos com estes tópicos:

Tarefas de programação gerais que você pode realizar usando o add-ins para Outlook. For more information, see Os suplementos de nível de aplicativo de programação..
Usando o modelo de objeto do Outlook. For more information, see 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. For more information, see Personalização de interface do usuário do Office.
A criação e depuração de suplementos em nível de aplicativo para o Outlook. For more information, see Criação e depuração de soluções do Office.
Implantando os suplementos de nível de aplicativo para Outlook. For more information, see Implantar soluções do Office.