Outlook 物件模型概觀

更新：2010 年 5 月

若要開發 Microsoft Office Outlook 的增益集，您可以與 Outlook 物件模型提供的物件進行互動。 Outlook 物件模型會提供表示使用者介面中各種項目的類別和介面。 例如，Application 物件表示整個應用程式、MAPIFolder 物件表示含有電子郵件訊息或其他項目的資料夾，而 MailItem 物件則表示電子郵件訊息。

此主題提供 Outlook 物件模型中部分主要物件的簡短概觀。 如需更多資源來了解整個 Outlook 物件模型，請參閱使用 Outlook 物件模型文件。

**適用於：**本主題中的資訊適用於 Outlook 2007 和 Outlook 2010 的應用程式層級專案。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

如需觀看相關示範影片，請參閱如何使用 Outlook 建立自訂工作報表？(英文)。

在 Outlook 專案中存取物件

Outlook 會提供許多您可以與之互動的物件。 若要有效使用物件模型，您應該熟悉下列最上層物件：

• Application

• Explorer

• Inspector

• MAPIFolder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

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 方法來擷取與該項目相關聯的偵測器。

MAPIFolder 物件

MAPIFolder 物件表示含有電子郵件訊息、連絡人、工作和其他項目的資料夾。 Outlook 會提供 16 個預設的 MAPIFolder 物件。

這些預設的 MAPIFolder 物件是由 OlDefaultFolders 列舉值所定義。 例如：

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox 會對應至 Outlook 中的 [收件匣] 資料夾。

如需示範如何存取預設 MAPIFolder 並建立新 MAPIFolder 的範例，請參閱 HOW TO：建立自訂資料夾項目。

MailItem 物件

MailItem 物件表示電子郵件訊息。 MailItem 物件通常是位於 [收件匣]、[寄件備份] 和 [寄件匣] 這類資料夾中。 MailItem 會公開 (Expose) 可用來建立和傳送電子郵件訊息的屬性和方法。

如需示範如何建立電子郵件訊息的範例，請參閱 HOW TO：建立電子郵件項目。

AppointmentItem 物件

AppointmentItem 物件表示 [行事曆] 資料夾中的會議、一次性約會或是週期性約會或會議。 AppointmentItem 物件含有一些可執行回應或轉寄會議邀請等動作的方法，以及一些可指定地點和時間等會議細節的屬性。

如需示範如何建立約會的範例，請參閱 HOW TO：建立會議邀請。

TaskItem 物件

TaskItem 物件表示要在指定的時間範圍內執行的工作。 TaskItem 物件是位在 [工作] 資料夾中。

若要建立工作，請使用 Application 物件的 CreateItem 方法，並傳入 olTaskItem 值做為參數。

ContactItem 物件

ContactItem物件表示 [連絡人] 資料夾中的連絡人。 ContactItem 物件含有它們所表示之人員的各種連絡資訊，例如街道地址、電子郵件地址和電話號碼。

如需示範如何建立新連絡人的範例，請參閱 HOW TO：將項目加入至 Outlook 連絡人。 如需示範如何搜尋現有連絡人的範例，請參閱 HOW TO：搜尋特定的連絡人。

使用 Outlook 物件模型文件

如需 Outlook 物件模型的完整資訊，您可以參閱 Outlook 主要 Interop 組件 (PIA) 參考和 VBA 物件模型參考。

主要 Interop 組件參考

Outlook PIA 參考記載 Outlook 2010 和 Outlook 2007 之主要 Interop 組件中的型別。 您可以從下列位置取得這份文件：

• Outlook 2010 主要 Interop 組件參考 (英文)

• Outlook 2007 主要 Interop 組件參考 (英文)

這份文件除了提供 PIA 中所有型別的資訊以外，還提供其他有關 PIA 結構的資訊以及常見 Outlook 自動化工作的程式碼範例。

VBA 物件模型參考

VBA 物件模型參考記載 Outlook 物件模型公開給 Visual Basic for Application (VBA) 程式碼時的資訊。 您可以從下列位置取得 Outlook 適用的 VBA 物件模型參考：

• Outlook 2010 物件模型參考 (英文)

• Outlook 2007 物件模型參考 (英文)

VBA 物件模型參考中的所有物件和成員都會對應至 Outlook PIA 中的型別和成員。 例如，VBA 物件模型參考中的 Inspector 物件會對應至 Outlook PIA 中的 Microsoft.Office.Interop.Outlook.Inspector 物件。 雖然 VBA 物件模型參考會提供大部分屬性、方法和事件的程式碼範例，但如果您想要在以 Visual Studio 建立的 Outlook 增益集專案中使用這些程式碼範例，您必須將此參考中的 VBA 程式碼改成 Visual Basic 或 Visual C# 程式碼。

相關主題

標題	描述
使用連絡人項目	所提供的主題示範如何使用連絡人執行工作。
使用郵件項目	所提供的主題示範如何使用郵件項目執行工作。
使用資料夾	所提供的主題示範如何使用資料夾執行工作。
使用行事曆項目	所提供的主題示範如何使用行事曆項目執行工作。
HOW TO：將 Windows Form 加入至 Outlook 方案	示範如何將 Windows Form 加入至 Microsoft Office Outlook 專案，並對使用者顯示表單。
HOW TO：從項目的自訂欄位讀取資料	示範如何從連絡人項目的自訂欄位讀取資料。
HOW TO：判斷未儲存項目的父資料夾	示範如何判斷未儲存連絡人項目的父 MAPIFolder。
HOW TO：判斷目前的 Outlook 項目	示範如何顯示目前資料夾的名稱以及已選取項目的某些相關資訊。

變更記錄

日期	記錄	原因
2010 年 5 月	更新有關物件模型參考文件的資訊。	資訊加強。