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

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

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

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

• 建立 Project 增益集專案。

• 撰寫可使用 Project 物件模型將工作加入至新專案的程式碼。

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

• 清除已完成的專案，好讓增益集不要在開發電腦上自動執行。

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

必要條件

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

-

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

• Project 2013 或 Project 2010。

建立專案

若要在 Visual Studio 中建立新專案

1. 啟動 Visual Studio。

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

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

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

5. 在專案範本清單中，選取 [Project 2010 增益集] 或 [Project 2013 增益集]。

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

7. 按一下 [確定]。

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

撰寫可將新工作加入至專案的程式碼

接著，將程式碼加入至 ThisAddIn 程式碼檔。新的程式碼會使用 Project 物件模型將新工作加入至專案。根據預設，ThisAddIn 程式碼檔包含下列產生的程式碼：

• ThisAddIn 類別的部分定義。這個類別提供您撰寫程式碼的進入點 (Entry Point)，並提供對 Project 物件模型的存取。如需詳細資訊，請參閱應用程式層級增益集程式設計。ThisAddIn 類別的其餘部分則定義於您不應修改的隱藏程式碼檔中。

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

若要將工作加入至新專案

• 在 ThisAddIn 程式碼檔中，加入下列程式碼至 ThisAddIn 類別。這段程式碼會定義 Microsoft.Office.Interop.MSProject.Application 類別之 NewProject 事件的事件處理常式。

  當使用者建立新專案時，這個事件處理常式會將工作加入至專案。

  Private Sub Application_NewProject(ByVal pj As Microsoft.Office.Interop.MSProject.Project) Handles Application.NewProject
      Dim newTask As MSProject.Task
      newTask = pj.Tasks.Add _
      ("This text was added by using code")
      newTask.Start = DateTime.Now
      newTask.Duration = "3"
      newTask.ResourceNames = "Rob Caron, Kelly Krout"
  End Sub
  

  void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj)
  {
      MSProject.Task newTask = pj.Tasks.Add
          ("This text was added by using code", missing);
      newTask.Start = DateTime.Now;
      newTask.Duration = "3";
      newTask.ResourceNames = "Rob Caron, Kelly Krout";
  }
  

為了修改專案，這個範例會使用下列物件：

• ThisAddIn 類別的 Application 欄位。Application 欄位會傳回 Microsoft.Office.Interop.MSProject.Application 物件，此物件代表 Project 目前的執行個體。

• NewProject 事件的事件處理常式的 pj 參數。pj 參數是表示專案的 Microsoft.Office.Interop.MSProject.Project 物件。如需詳細資訊，請參閱專案方案。

1. 如果使用的是 C#，請將下列程式碼加入 ThisAddIn_Startup 事件處理常式中。這段程式碼會連接 Application_Newproject 事件處理常式與 NewProject 事件。

   this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);
   

測試專案

建置和執行專案時，請確認新工作有出現在產生的新專案中。

若要測試專案

1. 按 F5 建置及執行專案。Microsoft Project 隨即啟動，並自動開啟新的空白專案。

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

2. 確認新工作已加入空白專案中。

3. 確認下列文字出現在工作的 [工作名稱] 欄位中。

   This text was added by using code.

4. 關閉 Microsoft Project。

清除專案

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

若要清除專案

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

後續步驟

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

• 您可以透過 Project 增益集執行的一般程式設計工作：應用程式層級增益集程式設計。

• 使用 Project 物件模型：專案方案。

• 建置及偵錯 Project 應用程式層級增益集：建置 Office 方案。

• 部署 Project 應用程式層級增益集：部署 Office 方案。

請參閱

概念

專案方案

其他資源

應用程式層級增益集程式設計

建置 Office 方案

部署 Office 方案

Office 專案範本概觀