逐步解說：建立 Outlook 的第一個 VSTO 載入宏

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

適用於： 本主題中的資訊適用於 Outlook 的 VSTO 載入宏專案。 如需詳細資訊，請參閱 Office 應用程式 lication 和項目類型所提供的功能。

注意

有興趣開發跨多個平台擴充 Office 體驗的解決方案嗎？ 查看新的 Office 載入宏模型。 相較於 VSTO 載入宏和解決方案，Office 載入宏的使用量很小，而且您可以使用幾乎任何 Web 程式設計技術來建置它們，例如 HTML5、JavaScript、CSS3 和 XML。

本逐步解說將說明下列工作：

• 建立 Outlook 的 Outlook VSTO 增益集專案。

• 撰寫使用 Outlook 物件模型的程式碼，將文字加入新郵件訊息的主旨和本文。

• 建置和執行專案來進行測試。

• 清除已完成的專案，使得 VSTO 增益集不再於開發電腦上自動執行。

  注意

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

必要條件

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

• 此版 Visual Studio 包含 Microsoft Office Developer Tools。 如需詳細資訊，請參閱 設定計算機來開發 Office 解決方案。

• Microsoft Outlook

建立專案

在 Visual Studio 中建立新的 Outlook 專案

1. 啟動 Visual Studio。

2. 在 [檔案] 功能表上，指向 [開新檔案] ，然後按一下 [專案] 。

3. 在範本窗格中，展開 [Visual C#] Deploying Office Solutions 或 [Visual Basic] ，然後展開 [Office/SharePoint] 。

4. 在展開的 [Office/SharePoint] 節點下，選取 [Office 增益集] 節點。

5. 在專案範本清單中，選取 Outlook VSTO 增益集專案。

6. 在 [名稱] 方塊中輸入 FirstOutlookAddIn。

7. 按一下 [確定]。

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

撰寫將文字新增至每個新郵件訊息的程序代碼

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

• ThisAddIn 類別的部分定義。 這個類別提供您撰寫程式碼的進入點，並提供對 Outlook 物件模型的存取。 如需詳細資訊，請參閱 程式 VSTO 載入宏。類別的 ThisAddIn 其餘部分定義於您不應該修改的隱藏程式代碼檔案中。

• ThisAddIn_Startup 和 ThisAddIn_Shutdown 事件處理常式。 當 Outlook 載入和卸載 VSTO 增益集時，會呼叫這些事件處理常式。 請使用這些事件處理常式，在 VSTO 增益集載入時將它初始化，以及在 VSTO 增益集卸載時清除它所用的資源。 如需詳細資訊，請參閱 Office 專案中的事件。

將文字加入每封新郵件的主旨和本文

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

   C#

   Outlook.Inspectors inspectors;
   

   VB

   Private WithEvents inspectors As Outlook.Inspectors
   

2. 以下列程式碼取代 ThisAddIn_Startup 方法。 這個程式碼會將事件處理常式附加到 NewInspector 事件。

   C#

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

   VB

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

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

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

   C#

   void Inspectors_NewInspector(Microsoft.Office.Interop.Outlook.Inspector Inspector)
   {
       Outlook.MailItem mailItem = Inspector.CurrentItem as Outlook.MailItem;
       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";
           }
   
       }
   }
   

   VB

   Private Sub inspectors_NewInspector(ByVal Inspector As Microsoft.Office.Interop.Outlook.Inspector) Handles inspectors.NewInspector
       Dim mailItem As Outlook.MailItem = TryCast(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
   

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

• Application 類別的 ThisAddIn 類別的部分定義。 Application 欄位會傳回 Application 物件，此物件代表 Outlook 目前的執行個體。

• Inspector 事件之事件處理常式的 NewInspector 參數。 Inspector 參數是 Inspector 物件，代表新郵件的偵測器視窗。 如需詳細資訊，請參閱 Outlook 解決方案。

測試專案

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

測試專案

1. 按 F5 建置及執行專案。

   當您建置專案時，程式碼會編譯到包含在專案建置輸出資料夾中的組件。 Visual Studio 也會建立一組登錄項目，以便 Outlook 探索和載入 VSTO 增益集，而且會設定開發電腦中的安全性設定，讓 VSTO 增益集可以執行。 如需詳細資訊，請參閱 Office 方案建置程式概觀。

2. 在 Outlook 中建立新郵件。

3. 請確認下列文字加入郵件的主旨行和本文中。

   This text was added by using code.

4. 關閉 Outlook。

清除專案

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

清除專案

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

下一步

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

• 您可以使用 Outlook VSTO 增益集執行的一般程式設計工作。 如需詳細資訊，請參閱 程式 VSTO 載入宏。

• 使用 Outlook 的物件模型。 如需詳細資訊，請參閱 Outlook 解決方案。

• 自訂 Outlook 的 UI，例如，透過將自訂索引標籤加入功能區，或建立您專屬自訂工作窗格的方式。 如需詳細資訊，請參閱 Office UI 自定義。

• 建置及偵錯 Outlook VSTO 增益集。 如需詳細資訊，請參閱 建置 Office 解決方案。

• 部署 Outlook VSTO 增益集。 如需詳細資訊，請參閱 部署 Office 解決方案。

相關內容

• 程式 VSTO 載入宏
• Outlook 解決方案
• Office UI 自定義
• 建置 Office 解決方案
• 部署 Office 解決方案
• Office 項目範本概觀