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é ASP.NET k migraci ASP.NET Core. Tento rest článek obsahuje kroky pro pokračování v přírůstkové migraci.

Nastavení základního projektu ASP.NET

Informace o ASP.NET aplikacích MVC a webových rozhraní API najdete v tématu Informace o upgradu z ASP.NET MVC a webového rozhraní API na ASP.NET Core MVC. Informace o aplikacích webových formulářů ASP.NET Framework najdete v tématu Informace o upgradu z webových formulářů ASP.NET na ASP.NET Core.

Upgrade podpůrných knihoven

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 lze v těchto knihovnách použít k povolení podpory System.Web.HttpContext použití v knihovnách tříd. Pokud chcete povolit System.Web.HttpContext použití v knihovně:

1. Odebrání odkazu v System.Web souboru projektu
2. Microsoft.AspNetCore.SystemWebAdapters Přidání balíčku
3. Povolte cílení na více verzí a přidejte cíl .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. Cílení na více verzí 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 ASP.NET, která sdílí název s funkcí v ASP.NET Core, rozhraní API se výrazně liší. Prohlédnou si 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ů, které adaptéry můžou pomoct s aktualizací. 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í.