逐步解說：建立 Outlook 的第一個應用程式層級增益集

發行項
08/12/2011

本逐步解說將示範如何建立 Microsoft Office Outlook 的應用程式層級增益集。不論開啟哪一個 Outlook 項目，您在這類方案中建立的功能都可供應用程式本身使用。如需詳細資訊，請參閱 Office 方案開發概觀。

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

這個逐步解說將說明下列工作：

為 Outlook 建立 Outlook 增益集專案。
撰寫可使用 Outlook 物件模型將文字加入至新郵件之主旨和本文的程式碼。
建置和執行專案來進行測試。
清除已完成的專案，好讓增益集不要在開發電腦上自動執行。

注意事項
您的電腦可能會在下列說明中，以不同名稱或位置顯示某些 Visual Studio 使用者介面項目。您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。如需詳細資訊，請參閱 Visual Studio 設定。

必要條件

您需要下列元件才能完成此逐步解說：

包含 Microsoft Office 開發者工具的 Visual Studio 2010 版本。 如需詳細資訊，請參閱[設定電腦以開發 Office 方案](bb398242\(v=vs.100\).md)。

Microsoft Office Outlook 2007 或 Outlook 2010。

建立專案

若要在 Visual Studio 中建立新的 Outlook 專案

啟動 Visual Studio。
在 [檔案] 功能表上，指向 [新增]，然後按一下 [專案]。
在 [範本] 窗格中，展開 [Visual C#] 或 [Visual Basic]，然後展開 [Office]。
在展開的 [Office] 節點底下，選取 [2007] (如果您已安裝 Outlook 2007) 或選取 [2010] 節點 (如果您已安裝 Outlook 2010)。
在專案範本清單中，選取 [Outlook 2007 增益集] 或 [Outlook 2010 增益集]。
在 [名稱] 方塊中，輸入 FirstOutlookAddIn。
按一下 [確定]。

Visual Studio 會建立 FirstOutlookAddIn 專案，並在編輯器中開啟 ThisAddIn 程式碼檔。

撰寫可將文字加入至每個新郵件的程式碼

接著，將程式碼加入至 ThisAddIn 程式碼檔。新程式碼會使用 Outlook 物件模型，將文字加入至每個新郵件。根據預設，ThisAddIn 程式碼檔包含下列產生的程式碼：

ThisAddIn 類別的部分定義。這個類別提供程式碼的進入點 (Entry Point)，並提供對 Outlook 物件模型的存取。如需詳細資訊，請參閱應用程式層級增益集程式設計。 ThisAddIn 類別的其餘部分則定義於您不應修改的隱藏程式碼檔中。
ThisAddIn_Startup 和 ThisAddIn_Shutdown 事件處理常式。當 Outlook 載入和卸載增益集時，會呼叫這些事件處理常式。請使用這些事件處理常式，在增益集載入時將它初始化，以及在增益集卸載時清除它所用的資源。如需詳細資訊，請參閱 Office 專案中的事件。

若要將文字加入至每個新郵件的主旨和本文

在 ThisAddIn 程式碼檔中，於 ThisAddIn 類別中宣告名為 inspectors 的欄位。 inspectors 欄位會維護目前 Outlook 執行個體中偵測器視窗集合的參考。這個參考可以防止記憶體回收行程釋放包含 NewInspector 事件之事件處理常式的記憶體。
```
Private WithEvents inspectors As Outlook.Inspectors
```
```
Outlook.Inspectors inspectors;
```

以下列程式碼取代 ThisAddIn_Startup 方法。這段程式碼會將事件處理常式附加至 NewInspector 事件。

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
    inspectors = Me.Application.Inspectors
End Sub

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    inspectors = this.Application.Inspectors;
    inspectors.NewInspector +=
    new Microsoft.Office.Interop.Outlook.InspectorsEvents_NewInspectorEventHandler(Inspectors_NewInspector);
}

在 ThisAddIn 程式碼檔中，加入下列程式碼至 ThisAddIn 類別。這段程式碼會定義 NewInspector 事件的事件處理常式。

當使用者建立新郵件時，這個事件處理常式會將文字加入至該郵件的主旨列和本文。

Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
    Dim mailItem As Outlook.MailItem = CType(Inspector.CurrentItem, Outlook.MailItem)
    If Not (mailItem Is Nothing) Then
        If mailItem.EntryID Is Nothing Then
            mailItem.Subject = "This text was added by using code"
            mailItem.Body = "This text was added by using code"
        End If
    End If
End Sub

void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
{
    Outlook.MailItem mailItem = (Outlook.MailItem)Inspector.CurrentItem;
    if (mailItem != null)
    {
        if (mailItem.EntryID == null)
        {
            mailItem.Subject = "This text was added by using code";
            mailItem.Body = "This text was added by using code";
        }

    }
}

若要修改每個新郵件，前面的程式碼範例可以使用下列物件：

ThisAddIn 類別的 Application 欄位。 Application 欄位會傳回 Application 物件，此物件代表 Outlook 目前的執行個體。
NewInspector 事件的事件處理常式的 Inspector 參數。 Inspector 參數是 Inspector 物件，此物件代表新郵件的偵測器視窗。如需詳細資訊，請參閱 Outlook 方案。

測試專案

當您建置和執行該專案時，請確認這段文字有出現在新郵件的主旨列和本文中。

若要測試專案

按 F5 建置及執行專案。

當您建置專案時，程式碼會編譯到包含在專案建置輸出資料夾中的組件。 Visual Studio 也會建立一組登錄項目，好讓 Outlook 探索和載入增益集，而且會設定開發電腦中的安全性設定以執行增益集。如需詳細資訊，請參閱 Office 方案建置程序概觀。
在 Outlook 中，建立新郵件。
確認下列文字已加入至郵件的主旨列和本文。

This text was added by using code.
關閉 Outlook。

清除專案

當您完成專案開發時，請從開發電腦移除增益集組件、登錄項目和安全性設定。否則，每次在開發電腦上開啟 Outlook 時，增益集就會執行。

若要清除專案

在 Visual Studio 中，按一下 [建置] 功能表上的 [清除方案]。

後續步驟

現在您已經建立 Outlook 的基本應用程式層級增益集，可以從下列主題進一步了解如何開發增益集：

您可以使用 Outlook 增益集執行的一般程式設計工作。如需詳細資訊，請參閱應用程式層級增益集程式設計。
使用 Outlook 物件模型。如需詳細資訊，請參閱 Outlook 方案。
自訂 Outlook 的 UI，例如，透過將自訂索引標籤加入至功能區，或建立您專屬自訂工作窗格的方式。如需詳細資訊，請參閱 Office UI 自訂。
建置及偵錯 Outlook 應用程式層級增益集。如需詳細資訊，請參閱建置和偵錯 Office 方案。
部署 Outlook 應用程式層級增益集。如需詳細資訊，請參閱部署 Office 方案。

請參閱

其他資源