在應用程式層級專案中進行偵錯
更新：2007 年 11 月
適用於 |
|---|
本主題中的資訊僅適用於指定的 Visual Studio Tools for Office 專案和 Microsoft Office 版本。 專案類型
Microsoft Office 版本
如需詳細資訊，請參閱依應用程式和專案類型提供的功能。 |
您可以使用用於其他 Visual Studio 專案的相同 Microsoft Visual Studio 工具，來偵錯應用程式層級專案。在您偵錯應用程式層級專案時，也可以使用 Visual Studio 偵錯工具功能，例如可以插入中斷點以及在 [區域變數] 視窗中檢視變數。如需 Visual Studio 偵錯工具的詳細資訊，請參閱 Visual Studio 偵錯。如需應用程式層級專案的詳細資訊，請參閱 應用程式層級增益集的架構。
啟動和停止偵錯工具
與開始偵錯其他 Visual Studio 專案的方式相同，您可以開始偵錯應用程式層級專案，例如按 F5 鍵。當您開始偵錯專案時，就會啟動新的目標 Office 應用程式處理序並載入增益集。停止偵錯工具時，偵錯工具會強制結束應用程式處理序，或者如果將偵錯工具設定為中斷連結，就會中斷連結。如需詳細資訊，請參閱 Brief 配置、偵錯快速鍵。
顯示例外狀況
如果使用 Visual Studio Tools for Office 建立的增益集擲回例外狀況，則 Microsoft Office 應用程式會繼續執行，而不會顯示例外狀況。如果您想要在擲回增益集例外狀況時看見相關訊息，請將偵錯工具設定為在所有例外狀況中斷。如需詳細資訊，請參閱 HOW TO：處理 Office 專案中的錯誤。
此外，您也可以在可能擲回例外狀況的程式碼前後插入 Try...Catch 陳述式。如需如何使用 Try...Catch 陳述式的詳細資訊，請參閱 HOW TO：在 Visual Basic 中使用 Try…Catch 區塊測試程式碼和 HOW TO：使用 try/catch 處理例外狀況 (C# 程式設計手冊)。
偵錯停用的增益集
Microsoft Office 應用程式可以停用載入時無法如預期般運作的增益集。Microsoft Office 應用程式會停用增益集，以防止在每次應用程式啟動時載入有問題的程式碼。不過，在進行一般偵錯時，也很容易造成無法預期的行為。如需如何重新啟用增益集的詳細資訊，請參閱 HOW TO：重新啟用已停用的增益集。
Microsoft Office 應用程式有兩種停用增益集的方式：硬停用和軟停用。
硬停用
如果在載入增益集時執行的程式碼導致應用程式意外關閉，或者您在建構函式 (Constructor) 或 Startup 事件處理常式正在執行時停止偵錯工具，就會發生硬停用。
如果 Microsoft Office 2003 應用程式硬停用透過 Visual Studio Tools for Office 建立的增益集，則應用程式會同時停用增益集和 AddinLoader.dll。AddinLoader.dll 是用來載入透過 Visual Studio Tools for Office 建立的增益集。因此，目前的使用者無法載入使用 Visual Studio Tools for Office 針對該 Microsoft Office 應用程式建立的所有增益集。如需 AddinLoader.dll 的詳細資訊，請參閱應用程式層級增益集的架構。
如果 2007 Microsoft Office system 應用程式硬停用透過 Visual Studio Tools for Office 建立的增益集，則應用程式只會停用造成失敗的增益集。因此，使用 Visual Studio Tools for Office 針對該 Office 2007 應用程式建立的其他增益集會繼續載入。
軟停用
當增益集在建構函式或 Startup 事件處理常式中擲回未處理的例外狀況，而且 Microsoft Office 應用程式按預期方式關閉時，就會發生軟停用的狀況。應用程式可能只會停用目前的增益集，讓目前的使用者無法載入。當應用程式軟停用增益集時，它會將增益集的 LoadBehavior 登錄項目值設定為 2。LoadBehavior 項目位於下列登錄機碼底下：HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\<application name>\Addins\<add-in name>。如需這個登錄機碼的詳細資訊，請參閱應用程式層級增益集的登錄項目。
使用記錄檔和錯誤訊息來疑難排解增益集
Visual Studio Tools for Office Runtime 可以將啟動期間發生的所有錯誤寫入記錄檔，或在訊息方塊中顯示每則錯誤。這些選項預設是處於停用狀態。您可以建立環境變數，以開啟這些選項。
若要在訊息方塊中顯示每則錯誤，請建立 VSTO_SUPPRESSDISPLAYALERTS 環境變數並設定為 0 (零)。您可以刪除環境變數或將環境變數設定為 1 (一)，以隱藏訊息。
若要將錯誤寫入記錄檔，請建立 VSTO_LOGALERTS 環境變數並設定為 1 (一)。Visual Studio Tools for Office Runtime 會在含有應用程式資訊清單的資料夾中建立記錄檔。預設名稱是 <Manifestname>.manifest.log。若要停止記錄錯誤，請刪除環境變數或將它設定為 0 (零)。