逐步解說:偵錯增益集專案
這個逐步解說會說明如何建立簡單 Visual Studio 增益集專案,以及如何使用中斷點來偵錯專案。 如需詳細資訊,請參閱Breakpoints and Tracepoints。
增益集是使用 Visual Studio Automation 物件模型編譯的應用程式,可管理或自動化整合式開發環境 (IDE)。 如需詳細資訊,請參閱建立增益集和精靈。
注意事項 |
---|
根據您目前使用的設定或版本,您所看到的對話方塊與功能表指令可能會與 [說明] 中描述的不同。使用 [一般開發設定] 開發了這些程序。若要變更設定,請從 [工具] 功能表中選擇 [匯入和匯出設定]。如需詳細資訊,請參閱 Visual Studio 設定。 |
若要建立簡單的 Visual Studio 增益集專案
從 [檔案] 功能表上指向 [新增],然後按一下 [專案]。
在 [專案類型] 窗格中,展開 [其他專案類型],然後選取 [擴充性]。
在 [範本] 窗格中選取 [Visual Studio 增益集]。
在 [名稱] 欄位中輸入 SimpleAddIn 做為增益集專案名稱。 按一下 [確定]。
Add-in Wizard隨即啟動。
在 [歡迎使用增益集精靈] 頁面中,按一下 [下一步]。
在 [選取程式語言] 頁面中按一下 [使用 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 物件加入至您的增益集,方法是將 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; } } }
按一下 [全部儲存] 按鈕儲存工作。
若要偵錯 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 的第二個執行個體會關閉,並帶您返回第一個執行個體中的增益集程式碼。