使用快照調試程式對即時 ASP.NET Azure 應用程式進行偵錯

備註

快照偵錯功能已遭到棄置，並且在 Visual Studio 2022 及其後續版本中將不再可用。雖然沒有確切的替代品，但還有其他工具可以提供有用的診斷：

當您感興趣的程式碼執行時，快照除錯工具會擷取生產中應用程式的快照集。若要指示調試程式擷取快照集，您可以在程式代碼中設定快照點和記錄點。除錯工具可讓您確切地查看問題的詳細資訊，而不會影響生產應用程式的使用量。快照調試程式可協助您大幅減少解決生產環境中發生問題所需的時間。

快照點和記錄點與中斷點很相似，但和中斷點不的是，快照點不會在叫用時停止應用程式。一般而言，在快照點擷取快照集需要 10-20 毫秒。

在本教學課程中，您將：

先決條件

快照調試程式僅可在 Visual Studio 2017 Enterprise 版本15.5或更高版本中使用Azure 開發工作負載。（在 [個別元件] 索引標籤下，您會在 [偵錯和測試>] 下找到它快照除錯程式。）

如果尚未安裝，請安裝 Visual Studio 2019。如果您要從先前的 Visual Studio 安裝更新，請執行 Visual Studio 安裝程式，並檢查 ASP.NET 和 Web 開發工作負載中的快照調試程式元件。
基本或更新版本的 Azure App Service 方案。
快照集集合適用於在 Azure App Service 中執行的下列 Web 應用程式：
- ASP.NET .NET Framework 4.6.1 或更新版本上執行的應用程式。
- 在 Windows 上執行 .NET Core 2.0 或更新版本的 ASP.NET Core 應用程式。

在程式碼編輯器中，按一下您感興趣的某行程式碼左邊的空白區來設定快照點。確保是您知道能成功執行的程式碼。
點擊 [開始收集] 以開啟快照點。

小提示

您無法在檢視快照集時逐步執行，但您可以在程式代碼中放置多個快照點，以遵循不同程式碼行的執行。如果您的程式代碼中有多個快照點，快照調試程式可確保對應的快照集來自相同的用戶會話。快照調試程式會執行此作業，即使有許多使用者叫用您的應用程式也一樣。

設定捕捉點之後，您可以手動移至網站的瀏覽器檢視並執行標示的程式代碼行以產生快照集，或等候使用者從其使用網站時產生快照集。

命中快照點時，快照會出現在 [診斷工具] 視窗中。若要開啟此視窗，請選擇 [ 偵錯視窗顯示診斷工具< c1 /> ]。
雙擊截點以在程式碼編輯器中開啟快照。

在此檢視中，您可以將滑鼠停留在變數上以檢視數據提示、使用 [ 局部變數]、[ 監看式] 和 [ 呼叫堆棧 ] 視窗，以及評估表達式。

網站本身仍會實時運作，且使用者不會受到影響。根據預設，每個快照點只會擷取一個快照：擷取快照之後，快照點就會關閉。如果您想要在快照點擷取另一個快照，可以透過按一下 更新集合 來重新啟用快照點。

您也可以將更多快照點新增至您的應用程式，並使用 [ 更新集合 ] 按鈕加以開啟。

需要協助嗎？ 請參閱疑難排解和已知問題以及快照調試常見問題頁面。

如果很難在應用程式中重新建立特定狀態，請考慮使用條件式快照點。條件式快照點可協助您控制何時擷取快照，例如當變數包含您想要檢查的特定的值時。您可以使用表示式、篩選或命中次數來設定條件。

除了在點擊快照點時擷取快照集之外，您也可以設定快照點來記錄訊息（也就是建立記錄點）。您可以設定記錄點，而不需要重新部署您的應用程式。 Logpoint 是虛擬執行的，對執行中的應用程式不會造成任何影響或副作用。

以滑鼠右鍵按兩下快照點圖示（藍色六邊形），然後選擇 [ 設定]。
在 [快照點設定] 視窗中，選取 [ 動作]。
在 [ 訊息 ] 欄位中，您可以輸入要記錄的新記錄訊息。您也可以將變數放在大括弧內，以評估記錄訊息中的變數。

如果您選擇 [傳送至輸出視窗]，當觸發記錄點時，訊息會出現在 [診斷工具] 視窗中。

如果您選擇 傳送至應用程式日誌，當記錄點被觸發時，訊息會出現在您可以看到來自System.Diagnostics.Trace（或 .NET Core 中的ILogger）的訊息的任何位置，例如 App Insights。

在本教學課程中，您已瞭解如何使用App Services的快照調試程式。您可能想要閱讀這項功能的詳細數據。

此頁面對您有幫助嗎？