Zmiany zrywające zgodność w .NET 10

Jeśli migrujesz aplikację do platformy .NET 10, zmiany powodujące niekompatybilność wymienione tutaj mogą cię dotyczyć. Zmiany są pogrupowane 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ą:

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

  • Niezgodność źródła — w przypadku ponownego skompilowania przy użyciu nowego zestawu SDK lub składnika lub z przeznaczeniem dla nowego środowiska uruchomieniowego istniejący kod źródłowy może wymagać zmian w kodzie źródłowym, 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. To nie jest pełna lista zmian łamiących zgodność w frameworku .NET 10.

ASP.NET Core

Zobacz Zmiany powodujące niezgodność w ASP.NET Core 10.

Containers

Title Typ zmiany
Domyślne obrazy .NET używają systemu Ubuntu Zmiana zachowania
dotnet test wymaga zapisywalnego katalogu podstawowego artefaktów VSTest w kontenerach Zmiana zachowania

Podstawowe biblioteki platformy .NET

Title Typ zmiany
Przestarzałe elementy API Niezgodne źródło
Zmiana zachowania ActivitySource.CreateActivity i ActivitySource.StartActivity Zmiana zachowania
Ładowania niewywołujące błędu Arm64 SVE wymagają maski Niezgodne dane binarne/źródło
BufferedStream.WriteByte nie wykonuje już niejawnego opróżniania buforu Zmiana zachowania
Rozstrzyganie przeciążeń w C# 14 z parametrami Span Zmiana zachowania
Spójne zachowanie przesunięcia w matematyce generycznej Zmiana zachowania
Domyślna propagacja kontekstu śledzenia zaktualizowana do standardu W3C Zmiana zachowania
DriveInfo.DriveFormat zwraca typy systemu plików Linux Zmiana zachowania
Adnotacja DynamicallyAccessedMembers usunięta z konstruktora DefaultValueAttribute Niezgodne dane binarne/źródło
Jawny rozmiar struktury jest niedozwolony w przypadku InlineArray Binarna niezgodność
FilePatternMatch.Stem został zmieniony na nienullowalny Niezgodna/behawioralna zmiana źródła
GnuTarEntry i PaxTarEntry nie zawierają już domyślnie atime i ctime Zmiana zachowania
Analiza DirectoryControl LDAP jest teraz bardziej rygorystyczna Zmiana zachowania
Normalizacja wersji MacCatalyst Zmiana zachowania
Nazwane muteksy domyślnie mają zakres użytkownika w systemie Unix Zmiana zachowania
.NET środowisko uruchomieniowe nie udostępnia już domyślnych programów obsługi sygnałów zakończenia Zmiana zachowania
System.Linq.AsyncEnumerable uwzględniony w bibliotekach podstawowych Niezgodne źródło
Sprawdzanie poprawności argumentu Type.MakeGenericSignatureType Zmiana zachowania

Kryptografia

Title Typ zmiany
CompositeMLDsa zaktualizowany do wersji draft-08 Zmiana zachowania
CoseSigner.Key może mieć wartość null Niezgodna zmiana w zachowaniu i kodzie źródłowym
Nazwy członków MLDsa i SlhDsa SecretKey zostały zmienione Niezgodne źródło
Elementy pierwotne kryptograficzne OpenSSL nie są obsługiwane w systemie macOS Zmiana zachowania
Program OpenSSL 1.1.1 lub nowszy jest wymagany w systemie Unix Zmiana zachowania
Sprawdzanie poprawności X500DistinguishedName jest bardziej rygorystyczne Zmiana zachowania
Parametry klucza X509Certificate i PublicKey mogą mieć wartość null Niezgodna zmiana w zachowaniu i kodzie źródłowym
Zmieniono nazwę zmiennej środowiskowej na DOTNET_OPENSSL_VERSION_OVERRIDE Zmiana zachowania

Entity Framework Core

Zobacz Zmiany powodujące niezgodność w programie EF Core 10.

Extensions

Title Typ zmiany
Usługa BackgroundService uruchamia całą metodę ExecuteAsync jako zadanie Zmiana zachowania
Naprawianie problemów w GetKeyedService() i GetKeyedServices() z elementem AnyKey Zmiana zachowania
Wartości null zachowane w konfiguracji Zmiana zachowania
Komunikat nie jest już zduplikowany w danych wyjściowych dziennika konsoli Zmiana zachowania
ProviderAliasAttribute przeniesiono do zestawu Microsoft.Extensions.Logging.Abstractions Niezgodne źródło
Usunięto adnotację DynamicallyAccessedMembers z kodu Microsoft.Extensions.Configuration niebezpiecznego dla przycinania Binarna niezgodność

Globalization

Title Typ zmiany
Zmieniono nazwę zmiennej środowiskowej na DOTNET_ICU_VERSION_OVERRIDE Zmiana zachowania

Narzędzie do instalowania

Title Typ zmiany
dotnet.acquire API dla programu VS Code nie zawsze pobiera najnowszą wersję Zmiana zachowania

Interoperacyjność

Title Typ zmiany
Rzutowanie obiektu COM IDispatchEx na obiekt IReflect kończy się niepowodzeniem Zmiana zachowania
Aplikacje z jednym plikiem nie szukają już bibliotek natywnych w katalogu wykonywalnym Zmiana zachowania
Określenie parametru DllImportSearchPath.AssemblyDirectory wyszukuje tylko katalog zestawu Zmiana zachowania

Sieć

Title Typ zmiany
Obsługa protokołu HTTP/3 jest domyślnie wyłączona z funkcją PublishTrimmed Niezgodne źródło
MailAddress wymusza walidację kolejnych kropek Zmiana zachowania
Przesyłanie strumieniowe odpowiedzi HTTP jest domyślnie włączone w klien­tach HTTP przeglądarki Zmiana zachowania
Uri usunięto limity długości Zmiana zachowania

Reflection

Title Typ zmiany Wprowadzona wersja
Bardziej ograniczone adnotacje dotyczące elementu InvokeMember/FindMembers/DeclaredMembers Niezgodność behawioralna/źródłowa
Sprawdzanie poprawności argumentu Type.MakeGenericSignatureType Zmiana zachowania

Zestaw SDK i program MSBuild

Title Typ zmiany
interfejs true wiersza polecenia --interactive .NET domyślnie używa w scenariuszach użytkownika Zmiana zachowania
dotnet Polecenia CLI rejestrują dane niezwiązane z poleceniem do strumienia stderr Zmiana zachowania
Pakowanie narzędzi .NET tworzy pakiety narzędzi specyficzne dla identyfikatora RuntimeIdentifier Zmiana zachowania
Domyślna konfiguracja zmienia się z trybu „luźnych manifestów” na tryb „zestawów obciążeń roboczych” Zmiana zachowania
DefineConstants dla platform docelowych, które nie są dostępne w czasie oceny Zmiana zachowania
Pokrycie kodu EnableDynamicNativeInstrumentation domyślnie ma wartość false Zmiana zachowania
Skrypty dnx pomijają wybór zestawu SDK global.json Zmiana zachowania
plikdnx.ps1 nie jest już uwzględniony w zestawie SDK .NET Niezgodne źródło
Cudzysłowy podwójne w dyrektywach na poziomie pliku są niedozwolone Niezgodne źródło
dotnet new sln domyślnie używa formatu pliku SLNX Zmiana zachowania
dotnet package list wykonuje przywracanie Zmiana zachowania
dotnet restore audytuje pakiety przechodnie Zmiana zachowania
dotnet tool install --local domyślnie tworzy manifest Zmiana zachowania
dotnet watch zapisuje logi do stderr zamiast do stdout Zmiana zachowania
project.json nie jest obsługiwany w programie dotnet restore Niezgodne źródło
Obsługa odcisku palca SHA-1 jest przestarzała w dotnet nuget sign Zmiana zachowania
MSBUILDCUSTOMBUILDEVENTWARNING obejście awaryjne usunięte Zmiana zachowania
Obsługa zasobów kultury niestandardowej programu MSBuild Zmiana zachowania
NU1510 jest zgłaszany w przypadku odwołań bezpośrednich przycinanych przez NuGet Niezgodne źródło
Pakiety NuGet bez zasobów środowiska uruchomieniowego nie są uwzględniane w deps.json Niezgodne źródło
PackageReference bez wersji zgłasza błąd Zmiana zachowania
PrunePackageReference prywatyzuje bezpośrednie odwołania kwalifikujące się do przycięcia Zmiana zachowania
Ostrzeżenia HTTP promowane do błędów w dotnet package list i dotnet package search Niezgodna zmiana w zachowaniu i kodzie źródłowym
NUGET_ENABLE_ENHANCED_HTTP_RETRY usunięto zmienną środowiskową Zmiana zachowania
Źródła inspekcji NuGet nie zezwalają już domyślnie na niezabezpieczony protokół HTTP Zmiana zachowania
Program NuGet rejestruje błąd dotyczący nieprawidłowych identyfikatorów pakietów Zmiana zachowania
ToolCommandName nie ustawiono dla pakietów innych niż narzędzia Niezgodne źródło
Instalacja pakietu szablonów weryfikuje podpisy NuGet Zmiana zachowania

Serializacja

Title Typ zmiany
System.Text.Json sprawdza konflikty nazw właściwości Zmiana zachowania
Klasa XmlSerializer nie ignoruje już właściwości oznaczonych atrybutem ObsoleteAttribute Zmiana zachowania

Windows Forms

Title Typ zmiany
Przestarzałe elementy API Niezgodne źródło
Aplikacje odwołujące się zarówno do WPF, jak i WinForms muszą uściślać typy MenuItem i ContextMenu Niezgodne źródło
Zmieniono nazwę parametru w kodzie HtmlElement.InsertAdjacentElement Niezgodne źródło
Obcinanie obrazu pola wyboru TreeView Zmiana zachowania
StatusStrip domyślnie używa trybu RenderMode System Zmiana zachowania
System.Drawing OutOfMemoryException został zmieniony na ExternalException Zmiana zachowania

Windows Presentation Foundation (WPF)

Title Typ zmiany
Puste definicje kolumn i definicje wierszy są niedozwolone Niezgodne źródło
Nieprawidłowe użycie usługi DynamicResource powoduje awarię aplikacji Niezgodna/behawioralna zmiana źródła