Visão geral do modelo de objeto do Outlook

Artigo
08/25/2010

Para desenvolver Adicionar-ins para o Microsoft Office Outlook, você pode interagir com os objetos que são fornecidos pelo modelo de objeto do Outlook.O modelo de objeto do Outlook fornece classes que representam itens na interface do usuário.Por exemplo, a classe Application representa o aplicativo inteiro, a classe MAPIFolder representa uma pasta que contém mensagens de email ou outros itens e a classe MailItem representa uma mensagem de email.

Este tópico fornece uma breve visão geral de algumas das classes principais no modelo de objeto do Outlook.Para Concluir documentação para o modelo de objeto do Outlook, consulte de seções MSDN de referência do desenvolvedor do Outlook 2007 e bem- vindo para o o Microsoft Office Outlook 2003 VBA Idioma Reference.

Acessar objetos em um projeto do Outlook

O Outlook fornece várias classes com o qual você pode interagir.Para usar o modelo de objeto com eficiência, você deve estar familiarizado com as classes de nível superior a seguir:

Classe de aplicativo

A classe Application representa o aplicativo Outlook, e é a classe de nível mais alto no modelo de objeto do Outlook.Alguns dos membros mais importantes dessa classe Incluir:

O CreateItem método que você pode usar para criar um novo item como uma mensagem de email, tarefa ou compromisso.
A propriedade Explorers, que você pode usar para acessar as janelas que Exibir o conteúdo de uma pasta na interface de usuário do Outlook (UI).
A propriedade Inspectors, que você pode usar para acessar as janelas que Exibir o conteúdo de um Simples item, como uma Solicitar de mensagem ou a reunião de email.

Para obter uma instância da classe Application , use a propriedade Application da classe ThisAddin.

Classe ThisAddIn

Quando você cria um novo projeto de suplemento de Outlook, o Ferramentas do Visual Studio para o Office cria automaticamente um arquivo de código ThisAddIn.vb ou ThisAddIn.cs em seu novo projeto.Este arquivo de código define uma classe ThisAddin que herda OutlookAddIn.Você pode acessar os membros da classe OutlookAddIn usando as palavras-chave Me (no Visual Basic) ou this (em C#) dentro da classe ThisAddIn.Código que está fora da classe ThisAddIn pode acessar o objeto ThisAddIn usando o Estático propriedade Globals.ThisAddIn.

Observação:
Para ajudar a evitar segurança avisos quando você usa propriedades e métodos que são bloqueados pelo modelo de objeto do Outlook se proteger, Obter Objetos do Outlook de o ThisAddIn object.For more information, see Considerações de segurança específicas para soluções do Office.

Classe do Explorer

A classe Explorer representa uma janela que exibe o conteúdo de uma pasta que contém itens como mensagens de email, tarefas ou compromissos.A classe Explorer inclui métodos e propriedades que você pode usar para modificar a janela e eventos que são gerados quando a janela é alterada.

Para obter um objeto de Explorer, siga um destes procedimentos:

Use a propriedade de Explorers da classe Application para acessar Tudo objetos de Explorer no Outlook.
Use o método ActiveExplorer da classe Application para obter o Explorer que atualmente tem foco.
Use o método GetExplorer da classe MAPIFolder para obter o Explorer para a pasta atual.

Classe de inspetor

A classe Inspector representa uma janela que exibe um Simples item, como uma mensagem de email, tarefa ou compromisso.A classe Inspector inclui métodos e propriedades que você pode usar para modificar a janela e eventos que são gerados quando a janela é alterada.

Para obter um objeto de Inspector, siga um destes procedimentos:

Use a propriedade de Inspectors da classe Application para acessar Tudo objetos de Inspector no Outlook.
Use o método ActiveInspector da classe Application para obter o Inspector que atualmente tem foco.
Use o método GetInspector de um item específico, como um MailItem ou AppointmentItem, para recuperar o inspetor associado ele.

Classe MAPIFolder

A classe MAPIFolder representa uma pasta que contém mensagens de email, contatos, tarefas e outros itens.O Outlook fornece 16 padrão MAPIFolder objetos.

Os objetos de MAPIFolder padrão são definidos pelos valores de enumeração OlDefaultFolders.Por exemplo,

T:Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox corresponde à pasta de da caixa de entrada no Outlook.

Para obter um exemplo que mostra como acessar um padrão MAPIFolder e criar um novo MAPIFolder, consulte Como: Criar itens de pasta Personalizar.

Classe de MailItem

A classe MailItem representa uma mensagem de email.Objetos de MailItem geralmente estão em pastas, como De caixa de entrada, Itens enviadose de caixa de saída .MailItem expõe propriedades e métodos que podem ser usados para criar e enviar mensagens de email.

Para obter um exemplo que mostra como criar uma mensagem de email, consulte Como: Criar um item de email.

Classe de AppointmentItem

A classe AppointmentItem representa uma reunião, um compromisso único, ou um compromisso ou reunião recorrente na pasta calendário.A classe AppointmentItem inclui métodos que executam ações como responder a ou encaminhamento de solicitações de reunião e propriedades que especificam detalhes de reunião, como o local e o tempo.

Para obter um exemplo que mostra como criar um compromisso, consulte Como: Criar uma Solicitar de reunião.

Classe TaskItem

A classe TaskItem representa uma tarefa a ser executada em um tempo especificado Quadro.Objetos de TaskItem estão localizados na pasta Tarefas.

Para criar uma tarefa, use CreateItem método da classe Application e passar o valor olTaskItem para o parâmetro.

Classe ContactItem

The ContactItemclass represents a contact in the Contacts folder.ContactItem objetos contêm várias informações de contatos para as pessoas representar, como endereços, endereços de email e números de telefone.

Para obter um exemplo que mostra como criar um novo contato, consulte Como: Adicionar uma entrada a Contatos do Outlook.Para obter um exemplo que mostra como Pesquisarr um contato existente, consulte Como: Pesquisarr um contato específico..

Usando a documentação de modelo de objeto do Outlook

Para obter informações sobre as classes que você pode usar no modelo de objeto do Outlook, consulte os seguintes conjuntos de documentação:

O primeiro link fornece informações sobre as classes e interfaces do assembly de interoperabilidade primária para o Outlook.Os outros links fornecem informações sobre o modelo de objeto do Outlook como ele está exposto para o Visual Basic para código Applications (VBA).Cada conjunto de documentação tem vantagens e desvantagens para desenvolvedores que estiverem usando Ferramentas do Visual Studio para o Office.

Referência de assembly interoperabilidade primária

Esta documentação descreve Tudo tipos no Outlook principal interop assembly que você pode usar em projetos de Ferramentas do Visual Studio para o Office:

Ele descreve os tipos no assembly de interoperabilidade principal para o Outlook 2007.Portanto, se você estiver desenvolvendo um Outlook 2003 Adicionar - in, não será possível usar alguns dos classes e membros que Aparecerr desta documentação.Para obter descrições dos tipos e membros que estão disponíveis para o Outlook 2003, consulte o Microsoft Office Outlook 2003 VBA Idioma Referência.
Ele não fornece os exemplos de código no momento.

Referência do VBA

Tudo objetos e os membros a referência do VBA correspondem às classes e membros o assembly de interoperabilidade primária que você usar em projetos de Ferramentas do Visual Studio para o Office.Por exemplo, o objeto de Inspector na documentação do VBA do Outlook corresponde à classe Microsoft.Office.Interop.Outlook.Inspector no assembly de interoperabilidade primário.

A referência do VBA apresenta as seguintes vantagens:

Ela fornece exemplos de código para a maioria dos membros.

A referência do VBA possui as seguintes desvantagens:

Ela fornece exemplos de sintaxe e o código para VBA somente.Para usar os exemplos de código em um projeto Ferramentas do Visual Studio para o Office, você deve converter o código VBA para o Visual Basic ou Visual C#.

Tipos adicionais em assemblies de interoperabilidade primários

Os assemblies de interoperabilidade primários contêm muitos tipos que não estão disponíveis para VBA.Esses tipos adicionais ajudam a converter objetos no modelo de objeto de baseado em COM do Outlook para código gerenciado, não devem ser usadas diretamente em seu código.

Para obter mais informações, consulte arquitetura do PIA do Outlook.