Share via


開始使用從 ASP.NET 到 ASP.NET Core 的累加式移轉

如需大型移轉,建議您設定 Proxy 至原始 .NET Framework 應用程式的 ASP.NET Core 應用程式。 下圖顯示已啟用新 Proxy 的應用程式:

start migrating routes

若要了解此方法如何有助於移轉流程,請參閱從 ASP.NET 到 ASP.NET Core 的累加式移轉。 本文的其餘部分提供繼續進行累加式移轉的步驟。

設定 ASP.NET Core 專案

針對 ASP.NET MVC 和 Web API 應用程式,請參閱了解如何從 ASP.NET MVC 和 Web API 升級至 ASP.NET Core MVC。 針對 ASP.NET Framework Web Form 應用程式,請參閱了解如何從 ASP.NET Web Form 升級至 ASP.NET Core

升級支援程式庫

如果您在解決方案中具有您需要使用的支援程式庫,則這些程式庫必須升級至 .NET Standard 2.0 (如果可能的話)。 升級小幫手是此升級的絕佳工具。 如果程式庫無法以 .NET Standard 為目標,您可以將目標設為 .NET 6 或更新版本,連同原始專案中的 .NET Framework 目標或與原始專案一起的新專案。

這些程式庫中可以使用配接器,以啟用在類別庫中使用 System.Web.HttpContext 的支援。 若要啟用在程式庫中使用 System.Web.HttpContext

  1. 移除專案檔中對 System.Web 的參考
  2. 新增 Microsoft.AspNetCore.SystemWebAdapters 套件
  3. 啟用多重目標並新增 .NET 6 目標或更新版本,或將專案轉換為 .NET Standard 2.0。
  4. 確定目標 Framework 支援 .NET Core。 如果 .NET Standard 2.0 不夠用,則可以使用多重目標

此步驟可能需要變更一些專案,取決於您的解決方案結構。 升級小幫手可以協助您識別哪些專案需要變更,並將流程中的一些步驟自動化。

啟用工作階段支援

工作階段是 ASP.NET 常用的功能,與 ASP.NET Core 中的功能共用名稱,但 API 有很大的不同。 請參閱有關工作階段支援的文件。

啟用共用驗證支援

您可以使用 System.Web 配接器遠端驗證功能,在原始 ASP.NET 應用程式與新的 ASP.NET Core 應用程式之間共用驗證。 此功能可讓 ASP.NET Core 應用程式將驗證延遲至 ASP.NET 應用程式。 如需其他詳細資料,請參閱遠端應用程式連線遠端驗證文件。

一般使用指引

ASP.NET 與 ASP.NET Core 之間有一些差異,而配接器可以協助更新。 不過,有一些需要選擇加入的功能,因為其會產生一些成本。 也有無法調整的行為。 如需這些行為的清單,請參閱使用指引