Zmiany powodujące niezgodność w .NET 11

Jeśli migrujesz aplikację do .NET 11, istotne zmiany wymienione tutaj mogą mieć wpływ na Ciebie. Zmiany są grupowane według obszaru technologii, takiego jak ASP.NET Core lub Windows Forms.

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.

Uwaga / Notatka

Ten artykuł jest w toku. Nie jest to pełna lista zmian powodujących niezgodność w .NET 11.

Podstawowe biblioteki .NET

Title	Typ zmiany
Metody DateOnly i TimeOnly TryParse zgłaszają nieprawidłowe dane wejściowe	Zmiana zachowania
DeflateStream i GZipStream zapisują nagłówki i stopki dla pustego ładunku	Zmiana zachowania
Environment.TickCount został dostosowany do zachowania limitów czasu w Windows	Zmiana zachowania
Zaktualizowano maksymalną pojemność MemoryStream i zmieniono sposób obsługi wyjątków	Zmiana zachowania
API obsoletions z nie domyślnymi identyfikatorami diagnostycznymi (.NET 11)	Niezgodne źródło
API do odczytu TAR weryfikują sumy kontrolne nagłówka przy odczycie	Zmiana zachowania
ZipArchive.CreateAsync chętnie ładuje wpisy archiwum ZIP	Zmiana zachowania

Kryptografia

Title	Typ zmiany
DsA usunięte z systemu macOS	Zmiana zachowania

Rozszerzenia

Title	Typ zmiany
IHost.RunAsync i IHost.StopAsync zgłaszają wyjątek, gdy BackgroundService zawiedzie	Zmiana zachowania

Globalization

Title	Typ zmiany
Minimalna obsługiwana data kalendarza japońskiego została poprawiona	Zmiana zachowania

Interoperacyjność

Title	Typ zmiany
NativeAOT używa prefiksu lib dla danych wyjściowych biblioteki natywnej w systemie Unix	Zmiana zachowania

kompilator JIT

Title	Typ zmiany
Minimalne wymagania sprzętowe zostały zaktualizowane	Zmiana zachowania

Zestaw SDK i program MSBuild

Title	Typ zmiany
mono nie ustawiono docelowego uruchamiania aplikacji platformy .NET Framework	Zmiana zachowania