Zmiany powodujące niezgodność w programie ASP.NET Core 8

Jeśli migrujesz aplikację do ASP.NET Core 8, istotne zmiany wymienione tutaj mogą mieć wpływ na Ciebie.

Ten artykuł kategoryzuje każdą zmianę jako niekompatybilną binarnie lub niekompatybilną źródłowo, albo jako zmianę behawioralną:

  • Niekompatybilne binaria — w przypadku uruchamiania w nowym środowisku uruchomieniowym lub w stosunku do nowego składnika, istniejące pliki binarne mogą napotkać istotną zmianę w działaniu, taką jak niepowodzenie ładowania lub uruchomienia, i w takim przypadku wymagają ponownej kompilacji.

  • Niekompatybilne źródło — W przypadku ponownego skompilowania przy użyciu nowego zestawu SDK lub składnika albo w celu skierowania na nowe środowisko uruchomieniowe, istniejący kod źródłowy może wymagać wprowadzenia zmian, aby można go było pomyślnie skompilować.

  • Zmiana zachowania — istniejący kod i pliki binarne mogą zachowywać się inaczej w czasie wykonywania. Jeśli nowe zachowanie jest niepożądane, należy zaktualizować i ponownie skompilować istniejący kod.

Title Typ zmiany
ConcurrencyLimiterMiddleware jest przestarzałe Niezgodne źródło
Niestandardowe konwertery do serializacji usunięte Zmiana zachowania
Oprogramowanie pośredniczące nagłówków przekazywanych ignoruje nagłówki X-Forwarded-* z nieznanych serwerów proxy Zmiana zachowania
Oprogramowanie pośredniczące rejestrowania HTTP wymaga polecenia AddHttpLogging() Zmiana zachowania
ISystemClock jest przestarzały Niezgodne źródło
Minimalne interfejsy API: parametry IFormFile wymagają kontroli fałszerzowania Zmiana zachowania
Oprogramowanie pośredniczące ograniczające szybkość wymaga dodatku AddRateLimiter Zmiana zachowania
Zdarzenia tokenu zabezpieczającego zwracają token JsonWebToken Zmiana zachowania
Ustawienie domyślne TrimMode dla projektów zestawu Web SDK Niezgodne źródło