Changements disruptifs dans .NET 10

Si vous migrez une application vers .NET 10, les changements importants répertoriés ici peuvent vous affecter. Les changements sont regroupés par domaine technologique, par exemple ASP.NET Core ou Windows Forms.

Cet article catégorise chaque changement radical comme incompatible binaire ou incompatible source, ou comme un changement de comportement :

  • Incompatibilité binaire : lors de l’exécution sur le nouveau runtime ou le nouveau composant, les fichiers binaires existants peuvent rencontrer un changement cassant du comportement, tel que l’échec de chargement ou d’exécution, et, le cas échéant, exiger une recompilation.

  • Source incompatible : lorsqu’il est recompilé à l’aide du nouveau SDK ou du nouveau composant ou pour cibler le nouveau runtime, le code source existant peut nécessiter la compilation réussie des modifications sources.

  • Changement comportemental : le code et les fichiers binaires existants peuvent se comporter différemment lors de l’exécution. Si le nouveau comportement n’est pas souhaitable, le code existant doit être mis à jour et recompilé.

Note

Cet article est un travail en cours. Il ne s’agit pas d’une liste complète des changements cassants dans .NET 10.

ASP.NET Core

Voir modifications importantes dans ASP.NET Core 10.

Containers

Titre Type de changement
Les images de .NET par défaut utilisent Ubuntu Changements de comportement
dotnet test a besoin d’un répertoire de base d’artefacts VSTest accessible en écriture dans des conteneurs Changements de comportement

Bibliothèques .NET Core

Titre Type de changement
Éléments d’API obsolescents Source non compatible
Modification du comportement ActivitySource.CreateActivity et ActivitySource.StartActivity Changements de comportement
Les chargements non fautifs Arm64 SVE nécessitent un masque Binaire/source incompatible
BufferedStream.WriteByte n’effectue plus de vidage implicite Changements de comportement
Résolution de surcharge C# 14 avec paramètres span Changements de comportement
Comportement de décalage cohérent dans les mathématiques génériques Changements de comportement
Le propagateur de contexte de trace par défaut a été mis à jour conformément à la norme W3C Changements de comportement
DriveInfo.DriveFormat retourne les types de système de fichiers Linux Changements de comportement
Annotation DynamicallyAccessedMembers supprimée du constructeur de DefaultValueAttribute Binaire/source incompatible
Taille de struct explicite non autorisée avec InlineArray Incompatibilité binaire
FilePatternMatch.Stem est devenu non-nullable Source incompatible/changement de comportement
GnuTarEntry et PaxTarEntry n’incluent plus atime et ctime par défaut Changements de comportement
L’analyse LDAP DirectoryControl est désormais plus stricte Changements de comportement
Normalisation de la version MacCatalyst Changements de comportement
Les mutex nommés ont par défaut une portée utilisateur sous Unix Changements de comportement
.NET runtime ne fournit plus de gestionnaires de signal d’arrêt par défaut Changements de comportement
System.Linq.AsyncEnumerable est inclus dans les bibliothèques principales Source non compatible
Validation de l’argument Type.MakeGenericSignatureType Changements de comportement

Cryptography

Titre Type de changement
CompositeMLDsa mis à jour vers draft-08 Changements de comportement
CoseSigner.Key peut être null Changement incompatible de comportement/source
Membres MLDsa et SlhDsa 'SecretKey' renommés Source non compatible
Les primitives de chiffrement OpenSSL ne sont pas prises en charge sur macOS Changements de comportement
OpenSSL 1.1.1 ou version ultérieure requise sur Unix Changements de comportement
La validation X500DistinguishedName est plus stricte Changements de comportement
Les paramètres de clé X509Certificate et PublicKey peuvent être null Changement incompatible de comportement/source
Variable d’environnement renommée en DOTNET_OPENSSL_VERSION_OVERRIDE Changements de comportement

Entity Framework Core (infrastructure d'entité de base)

Consultez Changements cassants dans EF Core 10.

Extensions

Titre Type de changement
BackgroundService exécute l’ensemble d’ExecuteAsync en tant que tâche Changements de comportement
Résoudre les problèmes dans GetKeyedService() et GetKeyedServices() avec AnyKey Changements de comportement
Valeurs Null conservées dans la configuration Changements de comportement
Le message n’est plus dupliqué dans la sortie du journal de la console Changements de comportement
ProviderAliasAttribute a été déplacé vers l’assembly Microsoft.Extensions.Logging.Abstractions Source non compatible
Suppression de l’annotation DynamicallyAccessedMembers du code Microsoft.Extensions.Configuration non sécurisé pour le trimming Incompatibilité binaire

Globalization

Titre Type de changement
Variable d’environnement renommée en DOTNET_ICU_VERSION_OVERRIDE Changements de comportement

Outil d’installation

Titre Type de changement
dotnet.acquire API pour VS Code ne télécharge plus toujours la dernière version Changements de comportement

Interop

Titre Type de changement
La conversion transtypée de l’objet COM IDispatchEx en IReflect échoue Changements de comportement
Les applications à fichier unique ne recherchent plus de bibliothèques natives dans le répertoire exécutable Changements de comportement
La spécification de DllImportSearchPath.AssemblyDirectory recherche uniquement dans le répertoire d’assembly Changements de comportement

Networking

Titre Type de changement
Prise en charge http/3 désactivée par défaut avec PublishTrimmed Source non compatible
MailAddress applique la validation pour les points consécutifs Changements de comportement
Réponses HTTP en streaming activées par défaut dans les clients HTTP de navigateur Changements de comportement
Uri limites de longueur supprimées Changements de comportement

Reflection

Titre Type de changement Version introduite
Annotations plus restreintes sur InvokeMember/FindMembers/DeclaredMembers Incompatibilité comportementale/source
Validation de l’argument Type.MakeGenericSignatureType Changements de comportement

SDK et MSBuild

Titre Type de changement
.NET CLI --interactive utilise true par défaut dans les scénarios utilisateur Changements de comportement
dotnet Les commandes CLI journalisent les données non pertinentes pour les commandes dans stderr Changements de comportement
.NET empaquetage d’outils crée des paquets d’outils spécifiques à RuntimeIdentifier Changements de comportement
Configuration de charge de travail par défaut depuis les « manifestes libres » jusqu’aux « ensembles de charges de travail » Changements de comportement
DefineConstants pour les frameworks cibles non disponibles au moment de l’évaluation Changements de comportement
La couverture du code EnableDynamicNativeInstrumentation a la valeur false par défaut Changements de comportement
Les scripts dnx contournent la sélection du Kit de développement logiciel (SDK) dans global.json Changements de comportement
Le fichier dnx.ps1 n’est plus inclus dans le SDK .NET Source non compatible
Les guillemets doubles dans les directives au niveau du fichier ne sont pas autorisés Source non compatible
dotnet new sln est défini par défaut sur le format de fichier SLNX Changements de comportement
dotnet package list effectue la restauration Changements de comportement
dotnet restore audite les packages transitifs Changements de comportement
dotnet tool install --local crée un manifeste par défaut Changements de comportement
dotnet watch consigne sur stderr au lieu de stdout Changements de comportement
project.json n’est pas pris en charge dans dotnet restore Source non compatible
Prise en charge des empreintes digitales SHA-1 dépréciée dans dotnet nuget sign Changements de comportement
Échappatoire MSBUILDCUSTOMBUILDEVENTWARNING supprimée Changements de comportement
Gestion des ressources de culture personnalisée MSBuild Changements de comportement
NU1510 est levé pour les références directes élaguées par NuGet Source non compatible
Les packages NuGet sans ressources runtime ne sont pas inclus dans deps.json Source non compatible
PackageReference sans version génère une erreur Changements de comportement
PrunePackageReference rend privées les références directes pouvant être nettoyées Changements de comportement
Avertissements HTTP transformés en erreurs dans dotnet package list et dotnet package search Changement incompatible de comportement/source
Suppression de la variable d’environnement NUGET_ENABLE_ENHANCED_HTTP_RETRY Changements de comportement
Les sources d’audit NuGet n’autorisent plus http non sécurisé par défaut Changements de comportement
NuGet enregistre une erreur pour les ID de package non valides Changements de comportement
ToolCommandName non défini pour les packages non-outil Source non compatible
L’installation du package de modèle vérifie les signatures NuGet Changements de comportement

Sérialisation

Titre Type de changement
System.Text.Json vérifie les conflits de noms de propriété Changements de comportement
XmlSerializer n’ignore plus les propriétés marquées par ObsoleteAttribute Changements de comportement

Windows Forms

Titre Type de changement
Éléments d’API obsolescents Source non compatible
Les applications référençant à la fois WPF et WinForms doivent désambiguer les types MenuItem et ContextMenu Source non compatible
Paramètre renommé dans HtmlElement.InsertAdjacentElement Source non compatible
Troncation de l’image de case à cocher TreeView Changements de comportement
StatusStrip utilise System RenderMode par défaut Changements de comportement
System.Drawing OutOfMemoryException changé en ExternalException Changements de comportement

Windows Presentation Foundation (WPF)

Titre Type de changement
Les ColumnDefinitions vides et RowDefinitions ne sont pas autorisées Source non compatible
Une utilisation incorrecte de DynamicResource provoque un blocage de l’application Source incompatible/changement de comportement