共用方式為

從 ASP.NET 到 ASP.NET Core 的累加式更新

  • 發行項

對大多數的生產應用程式而言，將應用程式從 ASP.NET Framework 更新為 ASP.NET Core 並非易事。 這些應用程式通常會在新技術可用時予以納入，而且通常由許多舊版決策所組成。 本文提供將 ASP.NET Framework 應用程式更新至 ASP.NET Core 的工具指引和連結，盡可能減少變更。

其中一個較大的挑戰是在整個程式碼基底中普遍使用 HttpContext。 如果沒有累加方法和工具，則需要大規模重寫才能移除 HttpContext 相依性。 dotnet/systemweb-adapters 中的配接器提供一組執行階段協助程式，以最少改變在 ASP.NET Core 中運作的方式存取 ASP.NET Framework 應用程式中所使用的類型。

視使用的應用程式大小、相依性和非可攜式 API 而定，完整移轉可能需要相當多的付出。 為了在進行更新時持續將應用程式部署至生產環境，最好的模式是遵循Strangler Fig 模式。 「Strangler Fig 模式」允許在舊系統上採用累加方法持續開發，以新的服務取代特定功能片段。 本文件說明如何將 Strangler Fig 模式套用到要更新為 ASP.NET Core 的 ASP.NET 應用程式。

如果您想要略過本概觀文章並開始使用，請參閱 開始使用。

將應用程式移轉至 ASP.NET Core

開始移轉之前，應用程式會以 ASP.NET Framework 為目標，並在 Windows 上以其支援程式庫執行：

Before starting the migration

移轉一開始會根據成為進入點的 ASP.NET Core 引進新的應用程式。 傳入要求會移至 ASP.NET Core 應用程式，此應用程式會透過 YARP 處理要求或使用 Proxy 將要求送至 .NET Framework 應用程式。 首先，提供回應的大部分程式碼都位於 .NET Framework 應用程式，但 ASP.NET Core 應用程式現已設定要開始移轉路由：

start updating routes

若要移轉依賴 HttpContext 的商務邏輯，必須使用 Microsoft.AspNetCore.SystemWebAdapters 來建置程式庫。 使用 SystemWebAdapters 建置程式庫允許：

  • 要針對 .NET Framework、.NET Core 或 .NET Standard 2.0 建置的程式庫。
  • 確保程式庫使用可在 ASP.NET Framework 和 ASP.NET Core 上使用的 API。

Microsoft.AspNetCore.SystemWebAdapters

設定使用 YARP 的 ASP.NET Core 應用程式後，您就可以開始將路由從 ASP.NET Framework 更新為 ASP.NET Core。 例如，WebAPI 或 MVC 控制器動作方法、處理常式，或路由的一些其他實作。 如果路由可在 ASP.NET Core 應用程式中使用，則會進行比對並提供服務。

在移轉過程中，識別出必須更新才能在 .NET Core 上執行的其他服務和基礎結構。 依維護性順序列出的選項包括：

  1. 將程式碼移至共用程式庫
  2. 連結新專案中的程式碼
  3. 複製程式碼

最後，ASP.NET Core 應用程式會處理比 .NET Framework 應用程式更多的路由：

the ASP.NET Core app handles more of the routes

一旦不再需要 ASP.NET Framework 應用程式並予以刪除：

  • 應用程式正在 ASP.NET Core 應用程式堆疊上執行，但仍會使用配接器。
  • 剩餘的移轉工作正在移除配接器的使用。

final pic

Visual Studio 延伸模組 .NET 升級小幫手可協助將 ASP.NET Framework Web 應用程式升級為 ASP.NET Core。 如需詳細資訊，請參閱使用 Visual Studio 升級專案部落格文章。

System.Web 配接器

Microsoft.AspNetCore.SystemWebAdapters 命名空間是執行階段協助程式的集合，方便使用針對 System.Web 撰寫的程式碼，同時移至 ASP.NET Core。 有幾個套件可用於使用這些配接器的功能：

  • Microsoft.AspNetCore.SystemWebAdapters：此套件用於支援程式庫，並提供您可能依賴的 System.Web API，例如 HttpContext 和其他 API。 此套件的目標為 .NET Standard 2.0、.NET 4.5+ 和 .NET 6+。
  • Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices：此套件僅以 .NET Framework 為目標，旨在提供服務給可能需要提供累加式移轉的 ASP.NET Framework 應用程式。 這通常預計不會從程式庫參考，而是從應用程式本身參考。
  • Microsoft.AspNetCore.SystemWebAdapters.CoreServices：此套件僅以 .NET 6+ 為目標，旨在提供服務給 ASP.NET Core 應用程式來設定 System.Web API 的行為，以及選擇任何累加式移轉行為。 這通常預計不會從程式庫參考，而是從應用程式本身參考。
  • Microsoft.AspNetCore.SystemWebAdapters.Abstractions：此套件是支援套件，可為 ASP.NET Core 和 ASP.NET Framework 應用程式所用的服務提供抽象概念，例如工作階段狀態序列化。

如需此套件實用案例的範例，請參閱配接器一文。

如需使用指引，請參閱使用指引一文。

其他資源