逐步解說：偵錯增益集專案
更新：2007 年 11 月
這個逐步解說會說明如何建立簡單 Visual Studio 增益集專案，以及如何使用中斷點來偵錯專案。如需詳細資訊，請參閱中斷點和追蹤點。
增益集是使用 Visual Studio Automation 物件模型編譯的應用程式，可管理或自動化整合式開發環境 (IDE)。如需詳細資訊，請參閱建立增益集和精靈。
.gif "注意事項") 注意事項： |
|---|
根據目前使用的設定與版本，您所看到的對話方塊與功能表命令可能會與 [說明] 中所描述的不同。使用 [一般開發設定] 開發了這些程序。若要變更設定，請從 [工具] 功能表中選擇 [匯入和匯出設定]。如需詳細資訊，請參閱 Visual Studio 設定。 |
若要建立簡單的 Visual Studio 增益集專案
從 [檔案] 功能表上指向 [新增]，然後按一下 [專案]。
新增專案對話方塊隨即出現。
在 [專案類型] 窗格中，展開 [其他專案類型]，然後選取 [擴充性]。
在 [範本] 窗格中選取 [Visual Studio 增益集]。
在 [名稱] 欄位中輸入 SimpleAddIn 做為增益集專案名稱。按一下 [確定]。
在 [歡迎使用增益集精靈] 頁面中，按一下 [下一步]。
在 [選取程式語言] 頁面中按一下 [使用 Visual C# 建立增益集]，然後按一下 [下一步]。
在 [選擇主應用程式] 頁面中接受預設選項，再按一下 [下一步]。
在 [輸入名稱和描述] 頁面中，輸入 Simple Add-in 做為增益集的名稱，並輸入用來說明如何偵錯簡單的增益集做為增益集的說明，然後按一下 [下一步]。
在 [選擇增益集選項] 頁面中，核取 [是，建立 [工具] 功能表項目] 選項。接受其餘的預設值。按一下 [下一步]。
在 [[關於] 對話方塊資訊選擇] 頁面中，選取 [是，我希望增益集可以提供 [關於] 對話方塊資訊]，然後按一下 [下一步]。
在 [摘要] 頁面中按一下 [完成]。
[增益集精靈] 會產生新的增益集專案，並開啟 IDE，以檔案 Connect.cs 為焦點。這是包含增益集程式碼的主要類別。
在 [方案總管] 中，以滑鼠右鍵按一下 [參考] 節點，然後選取 [加入參考] 將參考加入至組件。
如此會允許在 System.Windows.Forms 命名空間中使用型別。
加入參考對話方塊隨即出現。
在 [.NET] 索引標籤中，按兩下 System.Windows.Forms.dll 元件。
在 [方案總管 中，對 System.Windows.Forms 命名空間的參考會顯示在 [參考] 節點之下。
此命名空間包含顯示「訊息方塊」所需要的程式碼，該程式碼使用於下列程式碼範例中。
在 Connect.cs 中，將下列陳述式加入 SimpleAddIn 範圍上方附近，以允許更容易使用 MessageBox 物件：
using System.Windows.Forms;藉由將 MessageBox.Show("Debugging a Simple Add-in"); 加入至 Connect.cs 中的 Exec 方法，把 MessageBox 物件加入至您的增益集：
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; } } }按一下 [全部儲存] 按鈕儲存工作。
若要偵錯 Visual Studio 增益集專案
在 Connect.cs 中按一下陳述式的左邊界：
MessageBox.Show("Debugging a Simple Add-in")會出現一個紅點 (或中斷點)，並且該行上的文字會以紅色反白顯示。
在 [偵錯] 功能表中按一下 [啟動偵錯]。
您目前的 Visual Studio 工作階段 (偵錯工具工作階段) 將會遺失焦點，而正在進行偵錯的程式將會開啟在 Visual Studio 的另一個執行個體中。
從正在偵錯的 Visual Studio IDE 中，按一下 [工具] 功能表。
[SimpleAddIn] 會列在功能表項目的最上方。
選取 [SimpleAddIn] 命令以執行增益集。
這會將您帶到在 Visual Studio 偵錯工具工作階段中設定中斷點的程式碼行，此行會以黃色反白顯示。
在偵錯工具工作階段的 [偵錯] 功能表中選取 [逐步執行]。
焦點會切換回已偵錯的程式。您的訊息方塊會隨即開啟，表示已經執行增益集。
按一下 [確定] 關閉訊息方塊。
在偵錯工具工作階段中，從 [偵錯] 功能表中選取 [繼續]。
已偵錯的 Visual Studio 工作階段會重新取得焦點。
結束已偵錯的 Visual Studio 工作階段。
在 Connect.cs 中，按一下在 MessageBox 陳述式旁設定的中斷點，以便將它從原始程式碼中移除。
您可以看到，在偵錯增益集時，會開啟 Visual Studio IDE 的另一個執行個體，以裝載執行中的增益集。第一個執行個體會顯示其程式碼，並且讓您可以偵錯 (例如，設定監看變數、中斷點等等)。當您完成偵錯時，IDE 的第二個執行個體會關閉，並帶您返回第一個執行個體中的增益集程式碼。