共用方式為


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

在 Visual Studio 2013 中,增益集已被取代。 我們建議您將增益集升級為 VSPackage 擴充功能。 如需如何升級的詳細資訊,請參閱 常見問題集:將增益集轉換成 VSPackage 擴充功能

本逐步解說會說明如何建立基本 Visual Studio 增益集專案,以及如何使用中斷點來偵錯專案。 如需詳細資訊,請參閱Breakpoints and Tracepoints

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

注意事項注意事項

在下列指示的某些 Visual Studio 使用者介面項目中,您的電腦可能會顯示不同的名稱或位置:您所擁有的 Visual Studio 版本和使用的設定決定了這些項目。如需詳細資訊,請參閱Visual Studio 中的自訂開發設定

若要建立基本的 Visual Studio 增益集專案

  1. 在功能表列上,選擇 [檔案]、[新增]、[專案]。

    New Project Dialog Box隨即出現。

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

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

  4. 在 [名稱] 欄位中輸入 SimpleAddIn。 選擇 [確定] 按鈕。

    Add-in Wizard隨即啟動。

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

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

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

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

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

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

  11. 在 [摘要] 頁面上,選擇 [完成] 按鈕。

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

  12. 在 [方案總管] 中,選擇專案捷徑功能表上的 [新增] 按鈕,[參考],然後選擇 [新增參考] 按鈕。

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

    [Add Reference] 對話方塊隨即出現。

  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"); 加入至 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 偵錯執行個體中的功能表列上,選擇 [工具]、[SimpleAddIn] 以執行增益集。

    這會帶您前往您設定的中斷點。

  4. 在偵錯執行個體中的功能表列上,選擇 [偵錯]、[逐步執行]。

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

  5. 選擇 [確定] 按鈕關閉訊息方塊。

  6. 在偵錯執行個體中的功能表列上,選擇 [偵錯]、[繼續]。

    關閉 Visual Studio 偵錯執行個體。

  7. 在 Connect.cs 中,移除 MessageBox 陳述式旁邊的中斷點。

請參閱

其他資源

建立增益集和精靈

Automation 與擴充性參考