Share via


逐步解說:偵錯增益集專案

這個逐步解說會說明如何建立簡單 Visual Studio 增益集專案,以及如何使用中斷點來偵錯專案。 如需詳細資訊,請參閱 中斷點和追蹤點

增益集是使用 Visual Studio Automation 物件模型編譯的應用程式,可管理或自動化整合式開發環境 (IDE)。 如需詳細資訊,請參閱建立增益集和精靈

注意事項注意事項

根據您目前使用的設定或版本,您所看到的對話方塊與功能表指令可能會與 [說明] 中描述的不同。 使用 [一般開發設定] 開發了這些程序。 若要變更設定,請從 [工具] 功能表中選擇 [匯入和匯出設定]。 如需詳細資訊,請參閱 使用設定

若要建立簡單的 Visual Studio 增益集專案

  1. 從 [檔案] 功能表上指向 [新增],然後按一下 [專案]。

    New Project Dialog Box隨即出現。

  2. 在 [專案類型] 窗格中,展開 [其他專案類型],然後選取 [擴充性]。

  3. 在 [範本] 窗格中選取 [Visual Studio 增益集]。

  4. 在 [名稱] 欄位中輸入 SimpleAddIn 做為增益集專案名稱。 按一下 [確定]。

    Welcome to the Add-In Wizard, Visual Studio Add-In Wizard隨即啟動。

  5. 在 [歡迎使用增益集精靈] 頁面中,按一下 [下一步]。

  6. 在 [選取程式語言] 頁面中按一下 [使用 Visual C# 建立增益集],然後按一下 [下一步]。

  7. 在 [選擇主應用程式] 頁面中接受預設選項,再按一下 [下一步]。

  8. 在 [輸入名稱和描述] 頁面中,輸入 Simple Add-in 做為增益集的名稱,並輸入用來說明如何偵錯簡單的增益集做為增益集的說明,然後按 [下一步]。 按 [下一步]。

  9. 在 [選擇增益集選項] 頁面中,核取 [是,建立 [工具] 功能表項目] 選項。接受其餘的預設值。 按一下 [下一步]。

  10. 在 [[關於] 對話方塊資訊選擇] 頁面中,選取 [是,我希望增益集可以提供 [關於] 對話方塊資訊],然後按一下 [下一步]。

  11. 在 [摘要] 頁面中按一下 [完成]。

    [增益集精靈] 會產生新的增益集專案,並開啟 IDE,以檔案 Connect.cs 為焦點。 這是包含增益集程式碼的主要類別。

  12. 在 [方案總管] 中,以滑鼠右鍵按一下 [參考] 節點,然後選取 [加入參考] 將參考加入至組件。

    如此會允許在 System.Windows.Forms 命名空間中使用型別。

    Add Reference Dialog Box隨即出現。

  13. 在 [.NET] 索引標籤中,按兩下 System.Windows.Forms.dll 元件。

    在 [方案總管 中,對 System.Windows.Forms 命名空間的參考會顯示在 [參考] 節點之下。

    此命名空間包含顯示「訊息方塊」所需要的程式碼,該程式碼使用於下列程式碼範例中。

  14. 在 Connect.cs 中,將下列陳述式加入 SimpleAddIn 範圍上方附近,以允許更容易使用 MessageBox 物件:

    using System.Windows.Forms;
    
  15. 將 MessageBox 物件加入至您的增益集,方法是將 MessageBox.Show("Debugging a Simple Add-in"); 加入至 Connect.cs 中的 Exec 方法:

    public void Exec(string commandName,
       vsCommandExecOption executeOption,
       ref object varIn, ref object varOut, ref bool handled)
    {
       handled = false;
       if(executeOption ==
          vsCommandExecOption.vsCommandExecOptionDoDefault)
       {
          if(commandName == "MyAddin1.Connect.MyAddin1")
          {
             handled = true;
             MessageBox.Show("Debugging a Simple Add-in");
             return;
          }
       }
    }
    
  16. 按一下 [全部儲存] 按鈕儲存工作。

若要偵錯 Visual Studio 增益集專案

  1. 在 Connect.cs 中按一下陳述式的左邊界:

    MessageBox.Show("Debugging a Simple Add-in")
    

    會出現一個紅點 (或中斷點),並且該行上的文字會以紅色反白顯示。

  2. 在 [偵錯] 功能表中按一下 [啟動偵錯]。

    您目前的 Visual Studio 工作階段 (偵錯工具工作階段) 將會失去焦點,而正在進行偵錯的程式將會開啟在 Visual Studio 的另一個執行個體中。

  3. 從正在偵錯的 Visual Studio IDE 中,按一下 [工具] 功能表。

    [SimpleAddIn] 會列在功能表項目的最上方。

  4. 選取 [SimpleAddIn] 命令以執行增益集。

    這會將您帶到在 Visual Studio 偵錯工具工作階段中設定中斷點的程式碼行,此行會以黃色反白顯示。

  5. 在偵錯工具工作階段的 [偵錯] 功能表中選取 [逐步執行]。

    焦點會切換回已偵錯的程式。 您的訊息方塊會隨即開啟,表示已經執行增益集。

  6. 按一下 [確定] 關閉訊息方塊。

  7. 在偵錯工具工作階段中,從 [偵錯] 功能表中選取 [繼續]。

    已偵錯的 Visual Studio 工作階段會重新取得焦點。

  8. 結束已偵錯的 Visual Studio 工作階段。

  9. 在 Connect.cs 中,按一下在 MessageBox 陳述式旁設定的中斷點,以便將它從原始程式碼中移除。

    您可以看到,在偵錯增益集時,會開啟 Visual Studio IDE 的另一個執行個體,以裝載執行中的增益集。 第一個執行個體會顯示其程式碼,並且讓您可以偵錯 (例如,設定監看變數、中斷點等等)。 當您完成偵錯時,IDE 的第二個執行個體會關閉,並帶您返回第一個執行個體中的增益集程式碼。

請參閱

其他資源

建立增益集和精靈

Automation 與擴充性參考