逐步解說：建立 Project 的第一個 VSTO 增益集

  • 發行項

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

適用對象：本主題中的資訊適用於 Project 的 VSTO 增益集專案。 如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

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

  • 建立 Project VSTO 增益集專案。

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

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

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

    注意

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

必要條件

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

建立專案

在 Visual Studio 中建立新專案

  1. 啟動 Visual Studio。

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

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

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

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

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

  7. 按一下 [確定]。

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

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

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

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

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

將工作加入新專案

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

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

    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";
}

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

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

  • NewProject 事件之事件處理常式的 pj 參數。 pj 參數是 Microsoft.Office.Interop.MSProject.Project 物件，此物件代表專案。 如需詳細資訊，請參閱 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 探索和載入 VSTO 增益集，而且會設定開發電腦中的安全性設定，讓 VSTO 增益集可以執行。 如需詳細資訊，請參閱 Office 解決方案建置程序概觀。

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

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

    This text was added by using code.

  4. 關閉 Microsoft Project。

清理專案

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

清除專案

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

下一步

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

相關內容