什麼是 .NET 升級小幫手?
.NET Upgrade Assistant 可協助將項目升級至較新版本的 .NET,並分析您的程式代碼以找出並修正潛在的不相容問題。 此工具的其中一個重點是協助將專案從 .NET Framework、.NET Core 或 .NET 移轉至最新版本的 .NET。 您可以使用延伸模組或工具來升級整個 .NET 專案,或專案的某些層面,例如將組態檔從較舊的類型移轉至較新的類型。
.NET Upgrade Assistant 會以 Visual Studio 擴充功能或命令行介面 (CLI) 工具的形式散發。
.NET Upgrade Assistant 包含可掃描專案及其相依性的分析引擎。 掃描完成之後,會產生報告,其中包含執行升級的詳細資訊。 您可以使用這項資訊來升級整個專案或專案的特定部分。
.NET Upgrade Assistant 支持升級以 C# 或 Visual Basic 編碼的專案。 支援下列專案類型:
- ASP.NET
- Azure Functions
- Windows Presentation Foundation
- Windows Forms
- 類別庫
- 主控台應用程式
- Xamarin Forms
- .NET MAUI
- .NET Native UWP
某些產品提供如何使用 .NET 升級小幫手的指引。
下列是支援的升級路徑:
- .NET Framework 至 .NET
- .NET Core 至 .NET
- Azure Functions v1-v3 至 v4 隔離 (以 net6.0+為目標)
- UWP 至 WinUI 3
- 舊版 .NET 至最新版 .NET
- Xamarin Forms 至 .NET MAUI
- XAML 檔案轉換僅支援升級命名空間。 如需更全面的轉換,請使用 Visual Studio 2022 17.6 版或更新版本。
啟動升級時,精靈會逐步引導您設定一些選項,再起始升級。 根據您要升級的項目類型,精靈會顯示不同的選項。 如需升級專案的範例,請參閱 使用 .NET Upgrade Assistant 升級專案。
根據您要升級的項目類型,您可以變更升級的執行方式。 專案類型會影響可用的選項,而且可能遺漏下列一或多個專案:
升級完成後,會顯示狀態畫面,其中顯示與升級相關聯的所有成品。 您可以展開每個升級成品,以閱讀狀態的詳細資訊。 下列清單描述狀態圖示:
- 未填滿的綠色核取記號:此工具找不到任何與要升級之成品相關的資訊。
- 填滿的綠色核取記號:成品已升級並順利完成。
- 黃色警告符號:成品已升級,但有您應該考慮的重要資訊。
- Red X:成品升級失敗。
此外,升級期間執行的動作會記錄到升級小幫手來源下的 [輸出] 視窗,如下圖所示:
升級項目之後,請徹底測試它!