Visão geral de modelo de objeto do OutlookOutlook object model overview

Para desenvolver suplementos do VSTO para Outlook do Microsoft Office, você pode interagir com os objetos que são fornecidos pelo modelo de objeto do Outlook.To develop VSTO Add-ins for Microsoft Office Outlook, you can interact with the objects that are provided by the Outlook object model. O modelo de objeto do Outlook fornece interfaces e classes que representam itens na interface do usuário.The Outlook object model provides classes and interfaces that represent items in the user interface. Por exemplo, o Microsoft.Office.Interop.Outlook.Application objeto representa o aplicativo inteiro, o Folder objeto representa uma pasta que contém mensagens de email ou outros itens, e o Microsoft.Office.Interop.Outlook.MailItem objeto representa uma mensagem de email.For example, the Microsoft.Office.Interop.Outlook.Application object represents the entire application, the Folder object represents a folder that contains e-mail messages or other items, and the Microsoft.Office.Interop.Outlook.MailItem object represents an e-mail message.

Este tópico fornece uma visão geral de alguns dos principais objetos no modelo de objeto do Outlook.This topic provides a brief overview of some of the main objects in the Outlook object model. Para obter recursos onde você pode aprender mais sobre todo o modelo de objeto do Outlook, consulte Use a documentação do modelo de objeto Outlook.For resources where you can learn more about the entire Outlook object model, see Use the Outlook object model documentation.

Aplica-se a: as informações neste tópico se aplicam para adicionar o VSTO-nos projetos do Outlook.Applies to: The information in this topic applies to VSTO Add-in projects for Outlook. Para obter mais informações, consulte recursos disponíveis por tipo de projeto e aplicativo do Office.For more information, see Features available by Office application and project type.

link para vídeo para uma demonstração em vídeo relacionada, consulte How do i: Use o Outlook para criar um relatório de tarefas personalizado?.link to video For a related video demonstration, see How do I: Use Outlook to create a custom task report?.

Acessar objetos em um projeto do OutlookAccess objects in an Outlook project

O Outlook fornece muitos objetos com os quais você pode interagir.Outlook provides many objects with which you can interact. Para usar efetivamente o modelo de objeto, você deve estar familiarizado com os seguintes objetos de nível superior:To use the object model effectively, you should be familiar with the following top-level objects:

Objeto de aplicativoApplication object

O Microsoft.Office.Interop.Outlook.Application objeto representa o aplicativo Outlook e é o objeto de nível superior no modelo de objeto do Outlook.The Microsoft.Office.Interop.Outlook.Application object represents the Outlook application, and it is the highest-level object in the Outlook object model. Alguns dos membros mais importantes desse objeto incluem:Some of the most important members of this object include:

  • O CreateItem método que você pode usar para criar um novo item como uma mensagem de email, uma tarefa ou um compromisso.The CreateItem method which you can use to create a new item such as an e-mail message, task, or appointment.

  • O Explorers propriedade, que você pode usar para acessar as janelas que exibem o conteúdo de uma pasta na interface de usuário (IU) do Outlook.The Explorers property, which you can use to access the windows that display the contents of a folder in the Outlook user interface (UI).

  • O Inspectors propriedade, que você pode usar para acessar as janelas que exibem o conteúdo de um único item, como uma solicitação de reunião ou de mensagem de email.The Inspectors property, which you can use to access the windows that display the contents of a single item, such as an e-mail message or meeting request.

    Para obter uma instância das Microsoft.Office.Interop.Outlook.Application do objeto, use o campo de aplicativo do ThisAddIn classe em seu projeto.To get an instance of the Microsoft.Office.Interop.Outlook.Application object, use the Application field of the ThisAddIn class in your project. Para obter mais informações, consulte suplementos do VSTO do programa.For more information, see Program VSTO Add-ins.

Note

Para evitar avisos de segurança quando você usa propriedades e métodos que estão bloqueados pelo object model guard do Outlook, obtenha objetos do Outlook do campo de aplicativo a ThisAddIn classe.To help avoid security warnings when you use properties and methods that are blocked by the Outlook object model guard, get Outlook objects from the Application field of the ThisAddIn class. Para obter mais informações, consulte considerações sobre segurança específicas para soluções do Office.For more information, see Specific security considerations for Office solutions.

Objeto ExplorerExplorer object

O Microsoft.Office.Interop.Outlook.Explorer objeto representa uma janela que exibe o conteúdo de uma pasta que contém itens como mensagens de email, tarefas ou compromissos.The Microsoft.Office.Interop.Outlook.Explorer object represents a window that displays the contents of a folder that contains items such as e-mail messages, tasks, or appointments. O Microsoft.Office.Interop.Outlook.Explorer objeto inclui métodos e propriedades que você pode usar para modificar a janela e eventos que são gerados quando a janela é alterado.The Microsoft.Office.Interop.Outlook.Explorer object includes methods and properties that you can use to modify the window, and events that are raised when the window changes.

Para obter um Microsoft.Office.Interop.Outlook.Explorer de objeto, faça o seguinte:To get an Microsoft.Office.Interop.Outlook.Explorer object, do one of the following:

Objeto do InspetorInspector object

O Microsoft.Office.Interop.Outlook.Inspector objeto representa uma janela que exibe um único item, como uma mensagem de email, uma tarefa ou um compromisso.The Microsoft.Office.Interop.Outlook.Inspector object represents a window that displays a single item such as an e-mail message, task, or appointment. O Microsoft.Office.Interop.Outlook.Inspector objeto inclui métodos e propriedades que você pode usar para modificar a janela e eventos que são gerados quando a janela é alterado.The Microsoft.Office.Interop.Outlook.Inspector object includes methods and properties that you can use to modify the window, and events that are raised when the window changes.

Para obter um Microsoft.Office.Interop.Outlook.Inspector de objeto, faça o seguinte:To get an Microsoft.Office.Interop.Outlook.Inspector object, do one of the following:

Objeto de pastaFolder object

O Folder objeto representa uma pasta que contém mensagens de email, contatos, tarefas e outros itens.The Folder object represents a folder that contains e-mail messages, contacts, tasks, and other items. O Outlook fornece o padrão de 16 Folder objetos.Outlook provides 16 default Folder objects.

O padrão Folder objetos são definidos pelo Microsoft.Office.Interop.Outlook.OlDefaultFolders valores de enumeração.The default Folder objects are defined by the Microsoft.Office.Interop.Outlook.OlDefaultFolders enumeration values. Por exemplo,For example,

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox corresponde do caixa de entrada pasta no Outlook.Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox corresponds to the Inbox folder in Outlook.

Para obter um exemplo que mostra como acessar um padrão Folder e crie um novo Folder, consulte como: criar itens de pasta personalizados programaticamente.For an example that shows how to access a default Folder and create a new Folder, see How to: Programmatically create custom folder items.

Objeto MailItemMailItem object

O Microsoft.Office.Interop.Outlook.MailItem objeto representa uma mensagem de email.The Microsoft.Office.Interop.Outlook.MailItem object represents an e-mail message. Microsoft.Office.Interop.Outlook.MailItem objetos são normalmente em pastas, como caixa de entrada, itens enviados, e caixa de saída.Microsoft.Office.Interop.Outlook.MailItem objects are usually in folders, such as Inbox, Sent Items, and Outbox. Microsoft.Office.Interop.Outlook.MailItem expõe as propriedades e métodos que podem ser usados para criar e enviar mensagens de email.Microsoft.Office.Interop.Outlook.MailItem exposes properties and methods that can be used to create and send e-mail messages.

Para obter um exemplo que mostra como criar uma mensagem de email, consulte como: criar programaticamente um item de email.For an example that shows how to create an e-mail message, see How to: Programmatically create an email item.

Objeto AppointmentItemAppointmentItem object

O Microsoft.Office.Interop.Outlook.AppointmentItem objeto representa uma reunião, um compromisso único ou um compromisso recorrente ou reunião na calendário pasta.The Microsoft.Office.Interop.Outlook.AppointmentItem object represents a meeting, a one-time appointment, or a recurring appointment or meeting in the Calendar folder. O Microsoft.Office.Interop.Outlook.AppointmentItem objeto inclui métodos que realizam ações como responder a ou encaminhamento de solicitações de reunião e propriedades que especificam os detalhes da reunião, como o local e a hora.The Microsoft.Office.Interop.Outlook.AppointmentItem object includes methods that perform actions such as responding to or forwarding meeting requests, and properties that specify meeting details such as the location and time.

Para obter um exemplo que mostra como criar um compromisso, consulte como: criar programaticamente uma solicitação de reunião.For an example that shows how to create an appointment, see How to: Programmatically create a meeting request.

Objeto TaskItemTaskItem object

O Microsoft.Office.Interop.Outlook.TaskItem objeto representa uma tarefa a ser executada em um intervalo de tempo especificado.The Microsoft.Office.Interop.Outlook.TaskItem object represents a task to be performed within a specified time frame. Microsoft.Office.Interop.Outlook.TaskItem os objetos estão localizados na tarefas pasta.Microsoft.Office.Interop.Outlook.TaskItem objects are located in the Tasks folder.

Para criar uma tarefa, use o CreateItem método o Microsoft.Office.Interop.Outlook.Application do objeto e passar o valor olTaskItem para o parâmetro.To create a task, use the CreateItem method of the Microsoft.Office.Interop.Outlook.Application object, and pass in the value olTaskItem for the parameter.

Objeto ContactItemContactItem object

O Microsoft.Office.Interop.Outlook.ContactItemobjeto representa um contato a contatos pasta.The Microsoft.Office.Interop.Outlook.ContactItemobject represents a contact in the Contacts folder. Microsoft.Office.Interop.Outlook.ContactItem os objetos contêm uma variedade de informações de contato para as pessoas com quem que eles representam, como endereços, endereços de email e números de telefone.Microsoft.Office.Interop.Outlook.ContactItem objects contain a variety of contact information for the people they represent, such as street addresses, e-mail addresses, and phone numbers.

Para obter um exemplo que mostra como criar um novo contato, consulte como: adicionar uma entrada a contatos do Outlook de forma programática.For an example that shows how to create a new contact, see How to: Programmatically add an entry to Outlook contacts. Para obter um exemplo que mostra como pesquisar um contato existente, consulte como: pesquisar um contato específico de forma programática.For an example that shows how to search for an existing contact, see How to: Programmatically search for a specific contact.

Use a documentação de modelo de objeto do OutlookUse the Outlook object model documentation

Para obter informações completas sobre o modelo de objeto do Outlook, você pode consultar para a referência de assembly de interoperabilidade primária (PIA) do Outlook e a referência de modelo de objeto do VBA.For complete information about the Outlook object model, you can refer to the Outlook primary interop assembly (PIA) reference and the VBA object model reference.

Referência de assembly de interoperabilidade primárioPrimary interop assembly reference

A referência de PIA Outlook documenta os tipos em assemblies de interoperabilidade primários para o Outlook 2010.The Outlook PIA reference documents the types in the primary interop assemblies for Outlook 2010. Para obter mais informações, consulte referência de assembly de interoperabilidade primária do Outlook 2010.For more information, see Outlook 2010 primary interop assembly reference.

Além de fornecer informações para todos os tipos de PIAs, esta documentação também fornece informações adicionais sobre a estrutura dos PIAs e exemplos de código para tarefas comuns de automação do Outlook.In addition to providing information for all of the types in the PIAs, this documentation also provides additional information about the structure of the PIAs and code examples for common Outlook automation tasks.

Referência de modelo de objeto do VBAVBA object model reference

A referência de modelo de objeto VBA documenta o modelo de objeto do Outlook, como ele é exposto ao Visual Basic para código Applications (VBA).The VBA object model reference documents the Outlook object model as it is exposed to Visual Basic for Applications (VBA) code. Para obter mais informações, consulte referência de modelo de objeto do Outlook 2010.For more information, see Outlook 2010 object model reference.

Todos os objetos e membros na referência de modelo de objeto do VBA correspondem aos tipos e membros no PIA do Outlook.All of the objects and members in the VBA object model reference correspond to types and members in the Outlook PIA. Por exemplo, o objeto do Inspetor na referência de modelo de objeto do VBA corresponde à Microsoft.Office.Interop.Outlook.Inspector objeto no PIA do Outlook.For example, the Inspector object in the VBA object model reference corresponds to the Microsoft.Office.Interop.Outlook.Inspector object in the Outlook PIA. Embora a referência de modelo de objeto VBA fornece exemplos de código para a maioria das propriedades, métodos e eventos, você deve converter o código VBA essa referência para o Visual Basic ou Visual c#, se você quiser usá-los em um projeto de suplemento de VSTO do Outlook que você cria usando Visual Studio.Although the VBA object model reference provides code examples for most properties, methods, and events, you must translate the VBA code in this reference to Visual Basic or Visual C# if you want to use them in an Outlook VSTO Add-In project that you create by using Visual Studio.

TítuloTitle DescriçãoDescription
Trabalhar com itens de contatoWork with contact items Fornece tópicos que mostram como executar tarefas com contatos.Provides topics that show how to perform tasks with contacts.
Trabalhar com itens de emailWork with mail items Fornece tópicos que mostram como executar tarefas com itens de email.Provides topics that show how to perform tasks with mail items.
Trabalhar com pastasWork with folders Fornece tópicos que mostram como executar tarefas de pastas.Provides topics that show how to perform tasks with folders.
Trabalhar com itens de calendárioWork with calendar items Fornece tópicos que mostram como executar tarefas com itens de calendário.Provides topics that show how to perform tasks with calendar items.
Como: determinar o item atual do Outlook de forma programáticaHow to: Programmatically determine the current Outlook item Mostra como exibir o nome da pasta atual e algumas informações sobre o item selecionado.Shows how to display the name of the current folder and some information about the selected item.