Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


Zmiany powodujące niezgodność w .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

Kontenery

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
Format Complex.ToString został zmieniony na <a; b> 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

Entity Framework Core

Istotne zmiany w programie EF Core 8

Rozszerzenia

Globalizacja

Interop

Sieć

Odbicie

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
Ustawianie wartości DebugSymbols na wartość false powoduje wyłączenie generowania pliku PDB Zmiana zachowania
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

Windows Forms

Zobacz też