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

  • Artigo

Essa explicação passo a passo mostra como criar um suplemento ao nível para o Microsoft Office Outlook.Os recursos que você criou em este tipo de solução estão disponíveis para o próprio aplicativo, independentemente de qual item do Outlook estiver aberto.Para obter mais informações, consulte 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 2013 e Outlook 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Essa explicação passo a passo mostra as seguintes tarefas:

  • Criando um projeto do suplemento ao Outlook para Outlook.

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

  • Compilação e execução do projeto testá-lo.

  • Limpando o projeto terminado de modo que o suplemento não executa automaticamente no seu computador de desenvolvimento.

ObservaçãoObservaçã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 de Visual Studio.

Pré-requisitos

Para completar este passo-a-passo, são necessários os seguintes componentes:

-

Uma edição do Visual Studio 2012 que inclui o Microsoft Office Developer Tools. Para obter mais informações, consulte [Configurando um computador para desenvolver soluções do Office](bb398242\(v=vs.110\).md).
  • Outlook 2013 ou Outlook 2010.

Criando o projeto

Para criar Outlook novo projeto no Visual Studio

  1. Inicie o Visual Studio

  2. No menu File, aponte para New, e em seguida, clique em Project.

  3. Em o painel de modelos, expanda Visual C# ou Visual Basicem seguida, expanda Office/SharePoint.

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

  5. Em a lista de modelos de projeto, de Suplemento do Outlook 2010 selecione ou de Suplemento do Outlook 2013.

  6. Em a caixa de Nome , digite FirstOutlookAddIn.

  7. Clique em OK.

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

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

Em seguida, adicione o código ao arquivo de código de 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 de ThisAddIn contém o seguinte código gerado:

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

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

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

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

    Private WithEvents inspectors As Outlook.Inspectors

    Outlook.Inspectors inspectors;

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

    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);
}

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

    Quando o usuário cria uma nova mensagem de email, este manipulador de eventos adiciona texto na 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 = TryCast(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 = 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 alterar cada nova mensagem de email, os exemplos anteriores de código usa os seguintes objetos:

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

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

Testar o projeto.

Quando você compilar e executar o projeto, verifique se o texto apareça na linha de assunto e no corpo de uma nova mensagem de email.

para testar o projeto

  1. Pressione F5 para compilar e executar o projeto.

    Quando você criar o projeto, o código é compilado em um assembly que é 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 Outlook para descobrir e carregar o suplemento, e configurar as configurações de segurança no computador de desenvolvimento para ativar o suplemento a execução.Para obter mais informações, consulte Passo a passo: Criando O primeiro nível do aplicativo Add-in para Outlook.

  2. Em o Outlook, crie uma nova mensagem de email.

  3. Verifique se o texto a seguir é adicionado para a linha de assunto e corpo da mensagem.

    Esse texto foi adicionado usando código.

  4. próximo Outlook.

limpando o projeto

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

Para limpar o seu projeto

  • Em o Visual Studio, no menu de Compilar , clique Limpar solução.

Próximas etapas

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

Consulte também

Outros recursos

Os suplementos de nível de aplicativo de programação.

Soluções do Outlook

Personalização de interface do usuário do Office

Construindo soluções do Office

Implantando uma solução do Office

Visão geral sobre modelos de projeto do Office