Zmiany w wersji .NET 11 powodujące niekompatybilność

Jeśli migrujesz aplikację do .NET 11, zmiany powodujące niezgodność 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
Walidacja CRC32 dodana podczas odczytywania wpisów archiwum ZIP	Zmiana zachowania
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, aby być zgodnym z działaniem limitu czasu w Windows	Zmiana zachowania
Zaktualizowano maksymalną pojemność MemoryStream i zmieniono sposób obsługi wyjątków	Zmiana zachowania
NamedPipeServerStream z parametrem PipeOptions.CurrentUserOnly zacieśnia uprawnienia plików gniazd Unix	Zmiana zachowania
Nullable.GetUnderlyingType zgłasza wyjątek dla niestandardowych podklas typu	Zmiana zachowania
API obsoletions z identyfikatorami diagnostycznymi innymi niż domyślne (.NET 11)	Niezgodne źródło
API do odczytu TAR weryfikują sumy kontrolne nagłówka przy odczycie	Zmiana zachowania
TarWriter używa wpisów typu HardLink dla plików z twardymi linkami	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

Sieć

Title	Typ zmiany
Domyślnie wyłączone pobieranie certyfikatów AIA na serwerze przez SslStream	Zmiana zachowania

.NET MAUI

Title	Typ zmiany
Minimalny poziom interfejsu API systemu Android podniesiony do 24	Zmiana zachowania

Zestaw SDK i program MSBuild

Title	Typ zmiany
Nie ustawiono docelowego celu uruchamiania mono dla aplikacji platformy .NET Framework	Zmiana zachowania
VsTest usuwa zależność od pliku Newtonsoft.Json	Niezgodne dane binarne/źródło