使用工具協助將 ASP.NET Framework 遷移至 ASP.NET Core

本文說明如何使用 Visual Studio .NET 升級小幫 手和 累加更新 方法，將 ASP.NET Framework 應用程式 （MVC、Web API 和 Web Forms） 升級至 ASP.NET Core。

警告

有一個已啟用 Copilot 的工具，可在新式 .NET 上保持最新狀態，但目前尚未啟用將 ASP.NET Framework 移轉至 ASP.NET Core。 如需詳細資訊，請參閱 GitHub Copilot 應用程式現代化 - 升級 .NET 的檔。

先決條件

如果您的 .NET Framework 專案在解決方案中具有所需的支持連結庫，則應該盡可能升級為 .NET Standard 2.0。 如需詳細資訊，請參閱 升級支持連結庫。

1. 安裝 .NET Upgrade Assistant Visual Studio 擴充功能。

2. 在 Visual Studio 中開啟您的 ASP.NET 架構解決方案。

3. 在 [方案總管] 中，以滑鼠右鍵按兩下要升級的項目，然後選取 [ 升級]。 選取 [ 並行逐步項目升級]，這是唯一可用的升級選項。

4. 針對升級目標，選取 [ 新增專案]。

5. 為專案命名並選擇最合適的範本。 如果您的解決方案包含多個專案類型，您可以稍後新增必要的服務：

   備註

   針對MVC專案： 選取 [ASP.NET 核心 MVC 範本]。

   針對 Web API 專案： 選取 [ASP.NET Core Web API 範本]。

   針對MVC + Web API專案： 選取 [ASP.NET 核心 MVC 範本]。

   針對 Web Forms 專案： 選取 [ASP.NET 核心 範本]。

6. 請選擇下一步

7. 選取目標 Framework 版本，然後選取 [ 下一步]。 如需詳細資訊，請參閱 .NET 和 .NET Core 支持原則。

   備註

   針對 Web Forms 專案： 選取 [完成] ，而不是 [ 下一步]，然後繼續進行步驟 9。

8. 檢閱 變更摘要，然後選取 [ 完成]。

9. [ 摘要] 步驟會顯示 <Framework Project> 現在已透過 Yarp Proxy 連線到 <Framework ProjectCore> 。

   備註

   針對MVC和Web API專案： 摘要包含顯示已移轉端點的餅圖。 選取 [升級控制器 ]，然後選取要升級的控制器。 選取要升級的元件，然後選取 升級選取項目。