Wprowadzenie do migracji przyrostowej ASP.NET do ASP.NET Core

W przypadku dużej migracji zalecamy skonfigurowanie aplikacji ASP.NET Core, która jest serwerem proxy oryginalnej aplikacji .NET Framework. Nowa aplikacja z obsługą serwera proxy jest pokazana na poniższej ilustracji:

Aby zrozumieć, jak to podejście jest przydatne w procesie migracji, zobacz Przyrostowe ASP.NET do migracji ASP.NET Core. W pozostałej części tego artykułu przedstawiono kroki umożliwiające kontynuowanie migracji przyrostowej.

Konfigurowanie projektu podstawowego ASP.NET

Aby uzyskać ASP.NET aplikacje MVC i web API, zobacz Learn to upgrade from ASP.NET MVC and Web API to ASP.NET Core MVC (Dowiedz się, jak uaktualnić interfejs ASP.NET MVC i internetowy interfejs API do usługi ASP.NET Core MVC). Aby uzyskać informacje o aplikacjach ASP.NET Framework Web Forms, zobacz Learn to upgrade from ASP.NET Web Forms to ASP.NET Core (Dowiedz się, jak uaktualnić ASP.NET Web Forms do platformy ASP.NET Core).

Uaktualnianie bibliotek pomocniczych

Jeśli masz biblioteki pomocnicze w rozwiązaniu, które należy użyć, należy je uaktualnić do platformy .NET Standard 2.0, jeśli to możliwe. Asystent uaktualniania to doskonałe narzędzie. Jeśli biblioteki nie mogą być przeznaczone dla platformy .NET Standard, możesz wybrać platformę .NET 6 lub nowszą wraz z obiektem docelowym programu .NET Framework w oryginalnym projekcie lub w nowym projekcie obok oryginalnego.

Karty mogą być używane w tych bibliotekach, aby umożliwić obsługę System.Web.HttpContext użycia w bibliotekach klas. Aby włączyć System.Web.HttpContext użycie w bibliotece:

1. Usuń odwołanie do System.Web elementu w pliku projektu
2. Microsoft.AspNetCore.SystemWebAdapters Dodawanie pakietu
3. Włącz wielowersyjność i dodaj docelowy program .NET 6 lub nowszy albo przekonwertuj projekt na platformę .NET Standard 2.0.
4. Upewnij się, że platforma docelowa obsługuje platformę .NET Core. Wiele elementów docelowych można użyć, jeśli platforma .NET Standard 2.0 nie jest wystarczająca

Ten krok może wymagać zmiany wielu projektów w zależności od struktury rozwiązania. Asystent uaktualniania może pomóc w zidentyfikowaniu, które z nich należy zmienić i zautomatyzować szereg kroków w procesie.

Włączanie obsługi sesji

Sesja jest często używaną funkcją ASP.NET, która udostępnia nazwę funkcji w ASP.NET Core interfejsy API są znacznie inne. Zapoznaj się z dokumentacją dotyczącą obsługi sesji.

Włączanie obsługi uwierzytelniania współużytkowanego

Istnieje możliwość udostępniania uwierzytelniania między oryginalną aplikacją ASP.NET a nową aplikacją ASP.NET Core przy użyciu System.Web funkcji zdalnego uwierzytelniania kart. Ta funkcja umożliwia aplikacji ASP.NET Core odroczenie uwierzytelniania w aplikacji ASP.NET. Aby uzyskać więcej informacji, zobacz dokumentację połączenia aplikacji zdalnej i uwierzytelniania zdalnego.

Ogólne wskazówki dotyczące użycia

Istnieje wiele różnic między ASP.NET a ASP.NET Core, które adaptery mogą pomóc w aktualizacji. Istnieją jednak pewne funkcje, które wymagają zgody, ponieważ generują one pewne koszty. Istnieją również zachowania, których nie można dostosować. Zobacz wskazówki dotyczące użycia, aby zapoznać się z listą tych elementów.