偵錯或停用 XAML 設計工具的專案程式碼

發行項
10/05/2023

在許多情況下，當應用程式在設計工具中執行時，專案程式碼若是嘗試存取會傳回不同值或以不同方式運作的屬性或方法，就可能造成「XAML 設計工具」中發生未處理的例外狀況。您可以偵錯 Visual Studio 另一個執行個體的專案程式碼來解決這些例外狀況；或暫時停用設計工具中的專案程式碼，防止例外狀況發生。

專案程式碼包括：

自訂控制項和使用者控制項
類別庫
值轉換器
標的為從專案程式碼產生之設計階段資料的繫結

當專案程式碼停用後，Visual Studio 會顯示預留位置。例如，Visual Studio 會顯示不再提供資料之繫結的屬性名稱，或不再執行之控制項的預留位置。

Unhandled exception dialog

判斷專案程式碼是否會造成例外狀況

在未處理的例外狀況對話方塊中，選擇 [按一下此處可重新載入設計工具] 連結。
在功能表列上選擇 [偵錯]>[開始偵錯]，以建置及執行應用程式。

如果應用程式順利建置並執行，則設計階段的例外狀況可能是由在設計工具中執行的專案程式碼所造成。

偵錯在設計工具中執行的專案程式碼

在未處理的例外狀況對話方塊中，選擇 [按一下此處可停用執行中的專案程式碼並重新載入設計工具] 連結。
在 [Windows 工作管理員] 中，選擇 [結束工作] 按鈕關閉 Visual Studio XAML 設計工具目前執行的所有執行個體。
在 Visual Studio 中，開啟包含要偵錯之程式碼或控制項的 XAML 頁面。
開啟 Visual Studio 的新執行個體，然後開啟您專案的第二個執行個體。
設定專案程式碼的中斷點。
在 Visual Studio 新執行個體的功能表上，選擇 [偵錯]>[附加至處理序]。

在 [附加至流程] 對話方塊中，在 [可用的流程] 清單中，選擇符合您所使用的 Visual Studio 版本，以及您要開發的平台 (請參閱下表)，然後選擇 [附加] 按鈕。

Visual Studio 版本	平台	程序名稱。
2017–2022	UWP 應用程式	UwpSurface.exe
2017–2022	WPF Core 應用程式	WpfSurface.exe
僅限 2019	WPF 架構	xDesProc.exe
僅限 2022	WPF 架構	WpfSurface.exe

重要

在 Visual Studio 2019 中，如果在 [工具]> [選項] > [環境] > [預覽功能]中啟用新的 WPF XAML 設計工具，則為 WpfSurface.exe。

在 Visual Studio 第一個執行個體的功能表列上，選擇 [偵錯]>[開始偵錯]。

您現在可以進入正在設計工具中執行的程式碼。

停用設計工具中的專案程式碼

在未處理的例外狀況對話方塊中，選擇 [按一下此處可停用執行中的專案程式碼並重新載入設計工具] 連結。
或者，在 XAML 設計工具的工具列上選擇 [停用專案程式碼] 按鈕。

您可以再次切換按鈕重新啟用專案程式碼。

注意

至於以 ARM 或 X64 處理器為目標的專案，Visual Studio 無法在設計工具中執行專案程式碼，所以停用設計工具中的 [停用專案程式碼] 按鈕。
無論哪個選項都會導致重新載入設計工具，然後停用所有相關聯專案的程式碼。

注意

停用專案程式碼會導致設計階段資料遺失。另一個方法是偵錯在設計工具中執行的程式碼。