Обзор объектной модели Outlook

Область применения:Visual StudioVisual Studio для Mac Visual Studio Code

Для разработки надстроек VSTO для Microsoft Office Outlook вы можете взаимодействовать с объектами, которые предоставляются объектной моделью Outlook. Объектная модель Outlook предоставляет классы и интерфейсы, которые представляют элементы пользовательского интерфейса. Например, объект Application представляет все приложение, объект Folder — папку, содержащую электронные сообщения или другие элементы, а объект MailItem — электронное сообщение.

Этот раздел содержит краткий обзор некоторых основных объектов в объектной модели Outlook. Дополнительные сведения о всей объектной модели Outlook см. в статье Использование документации по объектной модели Outlook.

Применимо к: Сведения в этом разделе относятся к проектам надстроек VSTO для Outlook. Дополнительные сведения см. в разделе Функции, доступные для приложения Office и типа проекта.

Доступ к объектам в проекте Outlook

Outlook предоставляет множество различных объектов, с которыми можно взаимодействовать. Для эффективного использования объектной модели вы должны быть знакомы со следующими объектами верхнего уровня:

• Application

• Explorer

• Inspector

• Folder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Объект приложения

Объект Application представляет приложение Outlook. Это объект самого верхнего уровня в объектной модели Outlook. Ниже перечислены некоторые наиболее важные члены этого объекта.

• Метод CreateItem , который можно использовать для создания элемента, например электронного сообщения, задачи или встречи.

• Свойство Explorers , которое можно использовать для доступа к окнам с содержимым папки в пользовательском интерфейсе Outlook.

• Свойство Inspectors , которое можно использовать для доступа к окнам с содержимым одного элемента, например электронного сообщения или приглашения на собрание.

  Чтобы получить экземпляр Application объекта , используйте поле ThisAddIn Application класса в проекте. Дополнительные сведения см. в разделе Программные надстройки VSTO.

Примечание

Чтобы избежать предупреждений системы безопасности при использовании свойств и методов, заблокированных защитой объектной модели Outlook, получите объекты Outlook из поля ThisAddIn Приложение класса . Дополнительные сведения см. в статье Рекомендации по обеспечению безопасности для решений Office.

объект Обозреватель

Объект Explorer представляет окно, отображающее содержимое папки с такими элементами, как электронные сообщения, задачи и встречи. Объект Explorer содержит методы и свойства, с помощью которых можно изменять окно, а также события, возникающие при изменении окна.

Чтобы получить объект Explorer , выполните одно из следующих действий.

• Используйте свойство Explorers объекта Application для доступа ко всем объектам Explorer в Outlook.

• Используйте метод ActiveExplorer объекта Application , чтобы получить Explorer , который имеет фокус в данный момент.

• Используйте метод GetExplorer объекта Folder, чтобы получить Explorer для текущей папки.

Объект Inspector

Объект Inspector представляет окно, в котором отображается отдельный элемент, например электронное сообщение, задача или встреча. Объект Inspector содержит методы и свойства, с помощью которых можно изменять окно, а также события, возникающие при изменении окна.

Чтобы получить объект Inspector , выполните одно из следующих действий.

• Используйте свойство Inspectors объекта Application для доступа ко всем объектам Inspector в Outlook.

• Используйте метод ActiveInspector объекта Application , чтобы получить Inspector , который имеет фокус в данный момент.

• Используйте метод GetInspector определенного элемента, такого как MailItem или AppointmentItem, для извлечения инспектора, связанного с ним.

Объект Folder

Объект Folder представляет папку, содержащую электронные сообщения, контакты, задачи и другие элементы. Outlook предоставляет 16 объектов Folder по умолчанию.

Объекты Folder по умолчанию определяются значениями перечисления OlDefaultFolders . Например,

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox соответствует папке "Входящие" в Outlook.

Пример, показывающий, как получить доступ к по умолчанию Folder и создать новый Folder, см. в разделе Практическое руководство. Программное создание пользовательских элементов папки.

Объект MailItem

Объект MailItem представляет электронное сообщение. ОбъектыMailItem обычно находятся в папках, таких как Входящие, Отправленныеи Исходящие. MailItem предоставляет свойства и методы, которые можно использовать для создания и отправки электронных сообщений.

Пример создания сообщения электронной почты см. в разделе Практическое руководство. Программное создание элемента электронной почты.

Объект AppointmentItem

Объект AppointmentItem представляет собрание, однократную или повторяющуюся встречу или собрание в папке Календарь . Объект AppointmentItem содержит методы для выполнения таких действий, как ответ на приглашения на собрание и их пересылка, а также свойства, определяющие сведения о встрече, например время и место проведения.

Пример создания встречи см. в разделе Практическое руководство. Программное создание приглашения на собрание.

Объект TaskItem

Объект TaskItem представляет задачу, выполняемую в течение заданного промежутка времени. ОбъектыTaskItem расположены в папке Задачи .

Чтобы создать задачу, используйте метод CreateItem объекта Application и передайте значение olTaskItem для параметра.

Объект ContactItem

Объект ContactItemпредставляет контакт в папке Контакты . ОбъектыContactItem содержат различные контактные данные для людей, которые они представляют, например адреса, электронные адреса и номера телефонов.

Пример создания контакта см. в разделе Практическое руководство. Программное добавление записи в контакты Outlook. Пример поиска существующего контакта см. в разделе Практическое руководство. Программный поиск определенного контакта.

Использование документации по объектной модели Outlook

Полные сведения об объектной модели Outlook см. в справочнике по основной сборке взаимодействия (PIA) Outlook и в справочнике по объектной модели VBA.

Справочник по основной сборке взаимодействия

В справочных документах по основной сборке взаимодействия Outlook описываются типы основной сборки взаимодействия для Outlook 2010. Дополнительные сведения см. в статье Справочник по основным сборкам взаимодействия Outlook 2010.

Помимо информации о всех типах в основных сборках взаимодействия, эта документация также содержит дополнительные сведения о структуре основных сборок взаимодействия и примеры кода для общих задач автоматизации Outlook.

Справочник по объектной модели VBA

В справочных документах по объектной модели VBA объектная модель Outlook описана в том виде, в котором она предоставляется коду Visual Basic для приложений. Дополнительные сведения см. в справочнике по объектной модели Outlook 2010.

Все объекты и элементы в справочнике объектной модели VBA соответствуют типам и участникам основной сборки взаимодействия Outlook. Например, объект Inspector в справочнике по объектной модели VBA соответствует объекту Inspector в Outlook PIA. Несмотря на то что в справочнике по объектной модели VBA содержатся примеры кода для большинства свойств, методов и событий, необходимо преобразовать код VBA в этом справочнике в код Visual Basic или Visual C#, если требуется использовать их в проекте надстройки VSTO для Outlook, создаваемом с помощью Visual Studio.

См. также

Заголовок	Описание
Работа с элементами контактов	Содержит разделы, в которых описывается выполнение задач с контактами.
Работа с почтовыми элементами	Содержит разделы, в которых описывается выполнение задач с элементами почты.
Работа с папками	Содержит разделы, в которых описывается выполнение задач с папками.
Работа с элементами календаря	Содержит разделы, в которых описывается выполнение задач с элементами календаря.
Практическое руководство. Программное определение текущего элемента Outlook	Здесь показано, как отобразить имя текущей папки и некоторые сведения о выбранном элементе.