Outlook 对象模型概述

项目
08/12/2011

更新：2010 年 5 月

若要开发 Microsoft Office Outlook 的外接程序，可以与 Outlook 对象模型提供的对象进行交互。 Outlook 对象模型提供表示用户界面中各项的类和接口。例如，Application 对象表示整个应用程序，MAPIFolder 对象表示包含电子邮件或其他项的文件夹，MailItem 对象表示电子邮件。

本主题简要概述了 Outlook 对象模型中的一些主要对象。有关可供了解整个 Outlook 对象模型更多相关信息的资源，请参见使用 Outlook 对象模型文档。

**适用于：**本主题中的信息适用于 Outlook 2007 和 Outlook 2010 的应用程序级项目。有关更多信息，请参见按 Office 应用程序和项目类型提供的功能。

链接到视频有关相关视频演示，请参见 How Do I: Use Outlook to Create a Custom Task Report?（如何使用 Outlook 创建自定义任务报告？）。

访问 Outlook 项目中的对象

Outlook 提供许多您可以与其进行交互的对象。若要有效地使用对象模型，应熟悉以下顶级对象：

Application 对象

Application 对象表示 Outlook 应用程序，它是 Outlook 对象模型中最高级的对象。此对象的一些最重要的成员包括：

CreateItem 方法，该方法可用来创建新项，例如电子邮件、任务或约会。
Explorers 属性，该属性可用来访问在 Outlook 用户界面 (UI) 中显示文件夹内容的窗口。
Inspectors 属性，该属性可用来访问显示单个项（如电子邮件或会议要求）内容的窗口。

若要获取 Application 对象的实例，请在项目中使用 ThisAddIn 类的 Application 字段。有关更多信息，请参见应用程序级外接程序编程。

提示

若要帮助避免在使用 Outlook 对象模型保护所阻止的属性和方法时出现安全警告，请从 ThisAddIn 类的 Application 字段获取 Outlook 对象。有关更多信息，请参见 Office 解决方案的特定安全注意事项。

Explorer 对象

Explorer 对象表示显示包含项（如电子邮件、任务或约会）的文件夹内容的窗口。 Explorer 对象包括可用来修改窗口的方法和属性，以及窗口更改时所引发的事件。

若要获取 Explorer 对象，请执行下列操作之一：

使用 Application 对象的 Explorers 属性访问 Outlook 中的所有 Explorer 对象。
使用 Application 对象的 ActiveExplorer 方法获取当前具有焦点的 Explorer。
使用 MAPIFolder 对象的 GetExplorer 方法获取当前文件夹的 Explorer。

Inspector 对象

Inspector 对象表示显示单个项（如电子邮件、任务或约会）的窗口。 Inspector 对象包括可用来修改窗口的方法和属性，以及窗口更改时所引发的事件。

若要获取 Inspector 对象，请执行下列操作之一：

使用 Application 对象的 Inspectors 属性访问 Outlook 中的所有 Inspector 对象。
使用 Application 对象的 ActiveInspector 方法获取当前具有焦点的 Inspector。
使用特定项（如 MailItem 或 AppointmentItem）的 GetInspector 方法检索与其关联的 Inspector。

MAPIFolder 对象

MAPIFolder 对象表示包含电子邮件、联系人、任务及其他项的文件夹。 Outlook 提供 16 个默认 MAPIFolder 对象。

默认 MAPIFolder 对象由 OlDefaultFolders 枚举值定义。例如，

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox 与 Outlook 中的**“收件箱”**文件夹相对应。

有关演示如何访问默认 MAPIFolder 和创建新 MAPIFolder 的示例，请参见如何：创建自定义文件夹项。

MailItem 对象

MailItem 对象表示电子邮件。 MailItem 对象通常在**“收件箱”、“已发送邮件”和“发件箱”**等文件夹中。 MailItem 公开可用于创建和发送电子邮件的属性和方法。

有关演示如何创建电子邮件的示例，请参见如何：创建电子邮件项。

AppointmentItem 对象

AppointmentItem 对象表示**“日历”**文件夹中的会议、一次性约会，或定期约会或会议。 AppointmentItem 对象包括执行操作（如响应或转发会议要求）的方法，以及指定会议详细信息（如位置和时间）的属性。

有关演示如何创建约会的示例，请参见如何：创建会议请求。

TaskItem 对象

TaskItem 对象表示要在指定的时间范围内执行的任务。 TaskItem 对象位于**“任务”**文件夹中。

若要创建任务，请使用 Application 对象的 CreateItem 方法，并为参数传入值 olTaskItem。

ContactItem 对象

ContactItem对象表示**“联系人”**文件夹中的联系人。 ContactItem 对象包含它们所表示的人的各种联系信息，如街道地址、电子邮件地址和电话号码。

有关演示如何创建新联系人的示例，请参见如何：向 Outlook 联系人添加项。有关演示如何搜索现有联系人的示例，请参见如何：搜索特定联系人。

使用 Outlook 对象模型文档

有关 Outlook 对象模型的完整信息，可以参阅 Outlook 主互操作程序集 (PIA) 参考和 VBA 对象模型参考。

主互操作程序集参考

Outlook PIA 参考介绍了 Outlook 2010 和 Outlook 2007 的主互操作程序集中的类型。此文档可从以下位置获取：

Outlook 2010 Primary Interop Assembly Reference（Outlook 2010 主互操作程序集参考）
Outlook 2007 Primary Interop Assembly Reference（Outlook 2007 主互操作程序集参考）

除了提供有关 PIA 中所有类型的信息之外，此文档还提供有关 PIA 结构的其他信息以及常见 Outlook 自动化任务的代码示例。

VBA 对象模型参考

VBA 对象模型参考介绍了向 Visual Basic for Applications (VBA) 代码公开的 Outlook 对象模型。 Outlook 的 VBA 对象模型参考可从以下位置获取：

VBA 对象模型参考中的所有对象和成员都对应于 Outlook PIA 中的类型和成员。例如，VBA 对象模型参考中的 Inspector 对象对应于 Outlook PIA 中的 Microsoft.Office.Interop.Outlook.Inspector 对象。虽然 VBA 对象模型参考为大多数属性、方法和事件提供了代码示例，但若要在使用 Visual Studio 创建的 Outlook 外接程序项目中使用这些代码示例，必须将此参考中的 VBA 代码转换为 Visual Basic 或 Visual C#。

标题	说明
使用联系人项	提供说明如何使用联系人执行任务的主题。
使用邮件项	提供说明如何使用邮件项执行任务的主题。
使用文件夹	提供说明如何使用文件夹执行任务的主题。
使用日历项	提供说明如何使用日历项执行任务的主题。
如何：向 Outlook 解决方案添加 Windows 窗体	说明如何向 Microsoft Office Outlook 项目添加 Windows 窗体并向用户显示该窗体。
如何：从项的自定义字段中读取数据	说明如何从联系人项的自定义字段读取数据。
如何：确定未保存项的父文件夹	说明如何确定未保存联系人项的父 MAPIFolder。
如何：确定当前的 Outlook 项	说明如何显示当前文件夹的名称以及有关选定项的某些信息。

修订记录

日期	修订记录	原因
2010 年 5 月	更新了有关对象模型参考文档的信息。	信息补充。

2010 年 5 月

更新了有关对象模型参考文档的信息。

信息补充。

通过