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.

ASP.NET Core

Zobacz Istotne zmiany w ASP.NET Core 11.

Podstawowe biblioteki .NET

Title	Typ zmiany
Zachowanie Assembly.GetCallingAssembly zmienia się, gdy obsługa śledzenia stosu jest wyłączona	Zmiana zachowania
CborReader i CborWriter wymuszają domyślną maksymalną głębokość zagnieżdżania	Zmiana zachowania
Wyniki złożonej wartości specjalnej są teraz zgodne z załącznikiem C23 G	Zmiana zachowania
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
Konwersje typów Decimal i BigInteger na liczby zmiennoprzecinkowe są poprawnie zaokrąglane	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
Funkcja Math.Round i MathF.Round zwraca poprawnie zaokrąglone wyniki	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
Funkcja PackagePart.GetStream() zwraca strumień niemożliwy do wyszukiwania dla skompresowanych części w pakietach ReadWrite	Zmiana zachowania
API obsoletions z identyfikatorami diagnostycznymi innymi niż domyślne (.NET 11)	Niezgodne źródło
SafeFileHandle.IsAsync i FileStream.IsAsync dokładnie odzwierciedlają stan braku blokowania w systemie Unix	Zmiana zachowania
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
Operacje tensorowe wyrównowują równoważne kształty i puste tensory	Zmiana zachowania
Operacje na tensorach odrzucają nieobsługiwane układy przechowywania	Zmiana zachowania
ZipArchive.CreateAsync chętnie ładuje wpisy archiwum ZIP	Zmiana zachowania

Kryptografia

Title	Typ zmiany
Przestarzałości API	Niezgodne źródło
Złożony ML-DSA w systemie Windows korzysta z implementacji natywnej	Zmiana zachowania
DsA usunięte z systemu macOS	Zmiana zachowania
Funkcja HKDF w Windows korzysta z implementacji CNG	Zmiana zachowania
Pobieranie certyfikatów AIA w systemie Linux ograniczono do dwóch prób podczas tworzenia łańcucha	Zmiana zachowania

Deployment

Title	Typ zmiany
configProperties w pliku .runtimeconfig.dev.json zastępują ustawienia w pliku .runtimeconfig.json	Zmiana zachowania

Rozszerzenia

Title	Typ zmiany
Asynchroniczne przeciążenia ChangeToken.OnChange ponownie powiązują istniejące wywołania zwrotne zwracające obiekt Task	Zmiana zachowania
FileConfigurationProvider nie zgłasza tokenu ponownego ładowania po zignorowaniu błędu ładowania	Zmiana zachowania
Wywołanie zwrotne FileConfigurationSource.OnLoadException jest wywoływane w przypadku błędów wejścia/wyjścia	Zmiana zachowania
IHost.RunAsync i IHost.StopAsync zgłaszają wyjątek, gdy BackgroundService zawiedzie	Zmiana zachowania
PhysicalFilesWatcher weryfikuje ścieżki root i FileSystemWatcher	Zmiana zachowania
Niektóre pakiety Microsoft.Extensions uwzględnione we współdzielonej platformie	Zmiana zachowania
Synchroniczny dostęp do opcji walidowanych asynchronicznie powoduje wyjątek	Niezgodność behawioralna/źródłowa

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
Konwersje zmiennoprzecinkowe na małe typy całkowite są saturujące	Zmiana zachowania
Minimalne wymagania sprzętowe zostały zaktualizowane	Zmiana zachowania

Sieć

Title	Typ zmiany
Metryki wysokiej kardynalności klienta HttpClient używają liczników z możliwością obserwowania	Zmiana zachowania
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
Skrypty dnx pomijają wybór zestawu SDK global.json	Zmiana zachowania
Nie ustawiono docelowego celu uruchamiania mono dla aplikacji platformy .NET Framework	Zmiana zachowania
Obsługa wiersza polecenia NativeAOT jest domyślnie włączona	Zmiana zachowania
Nu1703 ostrzega o pakietach korzystających z przestarzałych zasobów platformy MonoAndroid	Niezgodne źródło
Pakiet NuGet ostrzega o identyfikatorach pakietów z ograniczonymi znakami	Zmiana zachowania
Przywracanie nie wyszukuje folderu pakietów globalnych dla nowszej wersji	Niezgodne źródło
Wybór lokalnego środowiska uruchomieniowego kontenera zestawu SDK preferuje narzędzia natywne dla platformy	Zmiana zachowania
Pakiety silnika szablonów nie obsługują już platformy netstandard2.0	Niezgodne dane binarne/źródło
VsTest usuwa zależność od pliku Newtonsoft.Json	Niezgodne dane binarne/źródło