Udostępnij za pośrednictwem


Istotne zmiany na platformie .NET 8

Jeśli migrujesz aplikację do platformy .NET 8, zmiany powodujące niezgodność wymienione tutaj mogą mieć wpływ na Ciebie. Zmiany są pogrupowane według obszaru technologii, takiego jak ASP.NET Core lub Windows Forms.

Ten artykuł kategoryzuje każdą zmianę powodującą niezgodność jako niezgodną binarną lub niezgodną źródłową albo jako zmianę behawioralną:

  • Niezgodne dane binarne — w przypadku uruchamiania względem nowego środowiska uruchomieniowego lub składnika istniejące pliki binarne mogą napotkać niezgodną zmianę zachowania, taką jak niepowodzenie ładowania lub wykonywania, a jeśli tak, wymagaj ponownej kompilacji.

  • Niezgodne źródło — w przypadku ponownego skompilowania przy użyciu nowego zestawu SDK lub składnika lub docelowego nowego środowiska uruchomieniowego istniejący kod źródłowy może wymagać pomyślnego skompilowania zmian źródłowych.

  • 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.

ASP.NET Core

Tytuł Typ zmiany
ConcurrencyLimiterMiddleware jest przestarzałe Niezgodne źródło
Niestandardowe konwertery do serializacji usunięte 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

Kontenery

Tytuł Typ zmiany
Pakiet "ca-certificates" usunięty z obrazów alpine Niezgodność binarna
Obrazy kontenerów Debian uaktualnione do systemu Debian 12 Niezgodna/behawioralna zmiana binarna
Domyślny port ASP.NET Core został zmieniony na 8080 Zmiana zachowania
Pakiet Kerberos usunięty z obrazów Alpine i Debian Niezgodność binarna
Pakiet "libintl" usunięty z obrazów alpejskich Zmiana zachowania
Tagi kontenerów wieloplatformowych to tylko system Linux Zmiana zachowania
Nowy użytkownik "app" na obrazach systemu Linux Zmiana zachowania

Podstawowe biblioteki platformy .NET

Tytuł Typ zmiany
Nazwa operacji działania, gdy ma wartość null Zmiana zachowania
Zachowanie AnonymousPipeServerStream.Dispose Zmiana zachowania
Obsoletions interfejsu API z niestandardowymi identyfikatorami diagnostycznymi Niezgodne źródło
Mapowanie ukośników odwrotnych w ścieżkach plików systemu Unix Zmiana zachowania
Metody Base64.DecodeFromUtf8 ignorują białe znaki Zmiana zachowania
Usunięto obsługę typu wyliczenia opartego na wartości logicznej Zmiana zachowania
Bieżąca wyliczenie ścieżki katalogu dysku Zmiana zachowania
Funkcja Enumerable.Sum zgłasza nowy wyjątek OverflowException dla niektórych danych wejściowych Zmiana zachowania
FileStream zapisuje, gdy potok jest zamknięty Zmiana zachowania
Identyfikator FindSystemTimeZoneById nie zwraca nowego obiektu Zmiana zachowania
GC. Polecenie GetGeneration może zwrócić wartość Int32.MaxValue Zmiana zachowania
Zachowanie GetFolderPath w systemie Unix Zmiana zachowania
Polecenie GetSystemVersion nie zwraca już elementu ImageRuntimeVersion Zmiana zachowania
ITypeDescriptorContext — adnotacje dopuszczane do wartości null Niezgodne źródło
Starsza wersja Console.ReadKey została usunięta Zmiana zachowania
Konstruktorzy metod generują parametry z wartością HasDefaultValue ustawioną na false Zmiana zachowania
ProcessStartInfo.WindowStyle honorowany, gdy parametr UseShellExecute ma wartość false Zmiana zachowania
RuntimeIdentifier zwraca platformę, dla której utworzono środowisko uruchomieniowe Zmiana zachowania
Type.GetType zgłasza wyjątek dla wszystkich nieprawidłowych typów elementów Zmiana zachowania

Kryptografia

Tytuł Typ zmiany Wprowadzono
Rozmiar tagu uwierzytelniania narzędzia AesGcm w systemie macOS Zmiana zachowania Wersja zapoznawcza 1
RSA. EncryptValue i RSA. DecryptValue przestarzałe Niezgodne źródło Wersja zapoznawcza 1

Wdrożenie

Tytuł Typ zmiany
Host określa zasoby specyficzne dla identyfikatorów RID Niezgodna/behawioralna zmiana binarna
Program .NET Monitor zawiera tylko obrazy bez dystrybucji Zmiana zachowania
Właściwość StripSymbols domyślnie ma wartość true Zmiana zachowania

Entity Framework Core

Istotne zmiany w programie EF Core 8

Rozszerzenia

Tytuł Typ zmiany
AktywatorUtilities.CreateInstance zachowuje się spójnie Zmiana zachowania
ActivatorUtilities.CreateInstance wymaga dostawcy innego niż null Zmiana zachowania
ConfigurationBinder zgłasza niezgodną wartość Zmiana zachowania
Pakiet ConfigurationManager nie odwołuje się już do pliku System.Security.Permissions Niezgodne źródło
Pakiet DirectoryServices nie odwołuje się już do pliku System.Security.Permissions Niezgodne źródło
Puste klucze dodane do słownika przez powiązanie konfiguracji Zmiana zachowania
HostApplicationBuilder Ustawienia. Args szanowane przez hostApplicationBuilder ctor Zmiana zachowania
ManagementDateTimeConverter.ToDateTime zwraca czas lokalny Zmiana zachowania
System.Formats.Cbor DateTimeOffset, zmiana formatowania Zmiana zachowania

Globalizacja

Tytuł Typ zmiany
Konwertery dat i godzin honorować argument kultury Zmiana zachowania
Wartość domyślna TwoDigitYearMax to 2049 Zmiana zachowania

Interop

Tytuł Typ zmiany
CreateObjectFlags.Unwraps unwraps unwraps tylko w wystąpieniu docelowym Zmiana zachowania
Niestandardowe marshallers wymagają dodatkowych elementów członkowskich Niezgodne źródło
Interfejs API IDispatchImplAttribute został usunięty Niezgodność binarna
JsFunctionBinding niejawny publiczny konstruktor domyślny został usunięty Niezgodność binarna
Sejf Występnikihandle muszą mieć publiczny konstruktor Niezgodne źródło

Sieć

Tytuł Typ zmiany
Element SendFile zgłasza wyjątek NotSupportedException dla gniazd bez połączenia Zmiana zachowania

Odbicie

Tytuł Typ zmiany
IntPtr nie jest już używany dla typów wskaźników funkcji Zmiana zachowania

SDK

Tytuł Typ zmiany
Dane wyjściowe konsoli interfejsu wiersza polecenia używają protokołu UTF-8 Zmiana zachowania/Niezgodność źródła i danych binarnych
Kodowanie konsoli nie UTF-8 po zakończeniu Zmiana zachowania/Niezgodność binarna
Kontenery domyślnie używają tagu "latest" Zmiana zachowania
"dotnet pack" używa konfiguracji wydania Zmiana zachowania/Niezgodność źródła
Polecenie "dotnet publish" używa konfiguracji wydania Zmiana zachowania/Niezgodność źródła
Zduplikowane dane wyjściowe dla parametrów -getItem, -getProperty i -getTargetResult Zmiana zachowania
Niejawna using dla elementu System.Net.Http nie jest już dodawana Zmiana zachowania/Niezgodność źródła
Niestandardowe zdarzenia kompilacji pochodnej programu MSBuild przestarzałe Zmiana zachowania
Program MSBuild szanuje DOTNET_CLI_UI_LANGUAGE Zmiana zachowania
Aplikacje specyficzne dla środowiska uruchomieniowego nie są samodzielne Niezgodne źródło/binarne
--arch opcja nie oznacza samodzielnej Zmiana zachowania
Polecenie "dotnet restore" powoduje wygenerowanie ostrzeżeń o lukach w zabezpieczeniach Zmiana zachowania
Zestaw SDK używa mniejszego grafu RID Zmiana zachowania/Niezgodność źródła
Link źródłowy uwzględniony w zestawie SDK platformy .NET Niezgodne źródło
Przycinanie może nie być używane w programie .NET Standard lub .NET Framework Zmiana zachowania
Pakiety nieznajdowane na liście nie są instalowane domyślnie dla narzędzi platformy .NET Zmiana zachowania
Plik .user zaimportowany w kompilacjach zewnętrznych Zmiana zachowania
Wymagania dotyczące wersji zestawu .NET 8 SDK Niezgodne źródło

Serializacja

Tytuł Typ zmiany
BinaryFormatter wyłączony dla większości projektów Zmiana zachowania
Serializacja oparta na odbiciu odbicia projektów opublikowanychTrimmed kończy się niepowodzeniem Zmiana zachowania
deserializator oparty na Emocje ionie chętnie rozpoznaje metadane Zmiana zachowania

Windows Forms

Tytuł Typ zmiany
Zmiany układu zakotwiczenia Zmiana zachowania
Certyfikaty sprawdzane przed załadowaniem obrazów zdalnych w aplikacji PictureBox Zmiana zachowania
DefaultValueAttribute usunięto z niektórych właściwości Zmiana zachowania
WyjątekCollection ctor zgłasza argumentException Zmiana zachowania
Skalowanie formularzy zgodnie z trybem AutoScaleMode Zmiana zachowania
Wartość domyślna ImageList.ColorDepth to Depth32Bit Zmiana zachowania
System.Windows.Extensions nie odwołuje się do pliku System.Drawing.Common Niezgodne źródło
TableLayoutStyleCollection zgłasza wyjątek ArgumentException Zmiana zachowania
Minimalna i maksymalna wielkość formularzy najwyższego poziomu do dpi Zmiana zachowania
WFDEV002 obsoletion jest teraz błędem Niezgodne źródło

Zobacz też