Začínáme s přírůstkovou migrací ASP.NET do ASP.NET Core

Pro velkou migraci doporučujeme nastavit aplikaci ASP.NET Core, která proxy provádí na původní aplikaci .NET Framework. Nová aplikace s povoleným proxy serverem se zobrazuje na následujícím obrázku:

Pokud chcete zjistit, jak je tento přístup užitečný v procesu migrace, přečtěte si článek Přírůstková migrace z ASP.NET na ASP.NET Core. Zbývající část tohoto článku obsahuje kroky pro pokračování v přírůstkové migraci.

Nastavení základního projektu ASP.NET

Informace o upgradu z ASP.NET MVC, webového rozhraní API a webových formulářů na ASP.NET Core najdete v nápovědě k nastavení projektů potřebných pro přírůstkovou migraci.

Aktualizovat podpůrné knihovny

Pokud máte ve svém řešení podpůrné knihovny, které budete potřebovat použít, měli byste je upgradovat na .NET Standard 2.0, pokud je to možné. Pomocník s upgradem je pro to skvělým nástrojem. Pokud knihovny nemůžou cílit na .NET Standard, můžete cílit na .NET 6 nebo novější společně s cílem rozhraní .NET Framework v původním projektu nebo v novém projektu společně s původním projektem.

Adaptéry mohou být použity v těchto knihovnách, aby umožnily podporu použití System.Web.HttpContext v knihovnách tříd. Pokud chcete povolit System.Web.HttpContext použití v knihovně:

1. Odeberte odkaz na System.Web v souboru projektu
2. Přidejte balíček Microsoft.AspNetCore.SystemWebAdapters
3. Povolte cílení na více platforem a přidejte target .NET 6 nebo novější, nebo převeďte projekt na .NET Standard 2.0.
4. Ujistěte se, že cílová architektura podporuje .NET Core. Multicílění je možné použít, pokud rozhraní .NET Standard 2.0 nestačí.

Tento krok může vyžadovat, aby se v závislosti na struktuře řešení změnilo několik projektů. Pomocník s upgradem vám může pomoct určit, které z nich je potřeba změnit, a automatizovat několik kroků v procesu.

Povolení podpory relace

Relace je běžně používaná funkce v ASP.NET, která má stejné pojmenování jako funkce v ASP.NET Core, ale jejich rozhraní API se výrazně liší. Podívejte se na dokumentaci k podpoře relací.

Povolení podpory sdíleného ověřování

Ověřování je možné sdílet mezi původní ASP.NET aplikací a novou aplikací ASP.NET Core pomocí System.Web funkce vzdáleného ověřování adaptérů. Tato funkce umožňuje aplikaci ASP.NET Core odložit ověřování do aplikace ASP.NET. Další podrobnosti najdete v dokumentaci k připojení ke vzdálené aplikaci a vzdálenému ověřování .

Obecné pokyny k používání

Mezi ASP.NET a ASP.NET Core existuje celá řada rozdílů, s jejichž aktualizací mohou pomoci adaptéry. Existují ale některé funkce, které vyžadují výslovný souhlas, protože se za nich účtují určité náklady. Existují také chování, která nelze přizpůsobit. Seznam těchto informací najdete v doprovodných materiálech k používání .