在應用程式層級專案中進行偵錯

更新:2010 年 9 月

您可以使用用於其他 Visual Studio 專案的相同 Microsoft Visual Studio 工具,來偵錯應用程式層級專案。 您在偵錯應用程式層級專案時,也可以使用 Visual Studio 偵錯工具功能,例如插入中斷點以及在 [區域變數] 視窗中檢視變數。 如需 Visual Studio 偵錯工具的詳細資訊,請參閱 Visual Studio 偵錯。 如需應用程式層級專案的詳細資訊,請參閱 應用程式層級增益集的架構

**適用於:**本主題中的資訊適用於 Microsoft Office 2010 和 2007 Microsoft Office system 的應用程式層級專案。 如需詳細資訊,請參閱依 Office 應用程式和專案類型提供的功能

視訊的連結 如需觀看相關示範影片,請參閱如何:偵錯 VSTO 應用程式?(英文)。

啟動和停止偵錯工具

與開始偵錯其他 Visual Studio 專案的方式相同,您可以開始偵錯應用程式層級專案,例如按 F5 鍵。 當您開始偵錯專案時,就會啟動新的目標 Office 應用程式處理序並載入增益集。 停止偵錯工具時,偵錯工具會強制結束應用程式處理序,或者如果將偵錯工具設定為中斷連結,就會中斷連結。 如需詳細資訊,請參閱 Debugging Shortcut Keys, Brief Scheme

顯示例外狀況

如果以 Visual Studio 中的 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 應用程式有兩種停用增益集的方式:硬停用和軟停用。

硬停用

當增益集會導致應用程式非預期地關閉時,就可能發生硬停用。 在開發電腦上,如果您在增益集中的 Startup 事件處理常式正在執行時停止偵錯工具,也可能發生這種情形。 當增益集遭硬停用時,它會出現在應用程式的 [停用的項目] 清單中。

如果 Office 應用程式硬停用以 Visual Studio 中的 Office 開發工具建立的增益集,則應用程式只會停用造成失敗的增益集。 以 Visual Studio 中的 Office 開發工具針對該 Office 應用程式所建立的其他增益集會繼續載入。

軟停用

當增益集產生不會導致應用程式非預期地關閉的錯誤時,就可能發生軟停用。 例如,如果增益集在 Startup 事件處理常式正在執行時擲回無法處理的例外狀況,則應用程式可能會軟停用該增益集。 當增益集遭軟停用時,它會出現在應用程式的 [非使用中應用程式增益集] 清單中,而且應用程式會變更增益集的 LoadBehavior 登錄項目值,表示已經卸載該增益集。 如需 LoadBehavior 登錄項目的詳細資訊,請參閱應用程式層級增益集的登錄項目

使用事件檢視器疑難排解安裝錯誤

對於當您安裝或解除安裝 Office 方案時擲回的所有例外狀況,Visual Studio Tools for Office Runtime 會將相關訊息寫入至 Windows 事件檢視器。 您可以使用這些訊息,解決安裝和部署問題。 如需詳細資訊,請參閱 Office 方案的事件記錄

使用記錄檔和錯誤訊息來疑難排解啟動錯誤

Visual Studio Tools for Office Runtime 可以將啟動期間發生的所有錯誤寫入至記錄檔,或在訊息方塊中顯示每則錯誤。 這些選項預設是處於停用狀態。 您可以建立環境變數,以開啟這些選項。

若要在訊息方塊中顯示每則錯誤,請建立 VSTO_SUPPRESSDISPLAYALERTS 環境變數並設定為 0 (零)。 您可以刪除環境變數或將環境變數設定為 1 (一),以隱藏訊息。

若要將錯誤寫入記錄檔,請建立 VSTO_LOGALERTS 環境變數並設定為 1 (一)。 Visual Studio Tools for Office Runtime 會在增益集的部署資訊清單所在的資料夾中建立記錄檔,如果無法這樣做,則會在本機 %TEMP% 資料夾中建立記錄檔。 預設名稱是 add-in name.vsto.log。 若要停止記錄錯誤,請刪除環境變數或將它設定為 0 (零)。

請參閱

工作

HOW TO:重新啟用已停用的增益集

HOW TO:處理 Office 專案中的錯誤

其他資源

建置和偵錯 Office 方案

應用程式層級增益集程式設計

變更記錄

日期

記錄

原因

2010 年 9 月

新增有關使用事件檢視器來疑難排解安裝錯誤的章節。

資訊加強。

2010 年 5 月

更正一些有關記錄錯誤的詳細資料。

內容 Bug 修正。