Changements cassants dans .NET 11

Si vous migrez une application vers .NET 11, les changements cassants répertoriés ici peuvent vous affecter. Les modifications sont regroupées 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. Ceci n'est pas une liste complète des changements majeurs dans .NET 11.

ASP.NET Core

Voir Changements importants dans ASP.NET Core 11.

Containers

Titre Type de changement
dotnet test a besoin d’un répertoire de base d’artefacts VSTest accessible en écriture dans des conteneurs Changements de comportement

Bibliothèques de .NET principales

Titre Type de changement
Modification du comportement de Assembly.GetCallingAssembly lorsque la prise en charge de la trace de pile est désactivée Changements de comportement
CborReader et CborWriter appliquent une profondeur d’imbrication maximale par défaut Changements de comportement
Les résultats spéciaux complexes suivent désormais l’annexe G C23 Changements de comportement
Validation CRC32 ajoutée lors de la lecture des entrées d’archive ZIP Changements de comportement
Les méthodes DateOnly et TimeOnly TryParse lèvent une exception en cas d’entrée non valide Changements de comportement
Les conversions de Decimal et BigInteger en virgule flottante sont correctement arrondies Changements de comportement
DeflateStream et GZipStream écrivent des en-têtes et pieds de page pour un payload vide Changements de comportement
Environment.GetCommandLineArgs()[0] préserve le nom d’appel de l’apphost Changements de comportement
Environment.TickCount est cohérent avec le comportement de délai d’expiration de Windows Changements de comportement
La collection WMI générée et les wrappers d’énumérateur implémentent IDisposable Changement de comportement/source
Math.Round et MathF.Round retournent correctement les résultats arrondis Changements de comportement
Les mutex nommés ont par défaut une portée utilisateur sous Unix Changements de comportement
NamedPipeServerStream avec PipeOptions.CurrentUserOnly renforce les autorisations de fichier de socket Unix Changements de comportement
Nullable.GetUnderlyingType lève une exception pour les sous-classes personnalisées de Type Changements de comportement
PackagePart.GetStream() retourne un flux ne permettant pas le positionnement pour les composants compressés dans les packages ReadWrite Changements de comportement
Obsoletions d’API avec des ID de diagnostic non par défaut (.NET 11) Source non compatible
SafeFileHandle.IsAsync et FileStream.IsAsync reflètent avec précision l’état non bloquant sur Unix Changements de comportement
Les API de lecture TAR vérifient les sommes de contrôle d’en-tête lors de la lecture Changements de comportement
TarWriter utilise des entrées HardLink pour les fichiers liés en dur Changements de comportement
Les opérations sur les tenseurs alignent les formes équivalentes et les tenseurs vides Changements de comportement
Les opérations Tensor rejettent les dispositions de stockage non prises en charge Changements de comportement
ZipArchive.CreateAsync charge immédiatement les entrées d’archive ZIP Changements de comportement

Cryptography

Titre Type de changement
API obsolètes Source non compatible
Les ML-DSA composites sur Windows utilisent l’implémentation native Changements de comportement
DSA supprimé de macOS Changements de comportement
HKDF sur Windows utilise l’implémentation CNG Changements de comportement
Extraction de certificats AIA Linux limitée à deux extractions par build de chaîne Changements de comportement

Deployment

Titre Type de changement
configProperties dans .runtimeconfig.dev.json remplacent .runtimeconfig.json Changements de comportement

Extensions

Titre Type de changement
Les surcharges asynchrones de ChangeToken.OnChange relient à nouveau les rappels existants retournant Task Changements de comportement
L’élimination de la portée d’injection de dépendances agrège les exceptions Changements de comportement
Les chaînes vides dans la configuration chaînée remplacent les fournisseurs de configuration antérieurs Changements de comportement
FileConfigurationProvider ne déclenche pas de jeton de rechargement après l’échec de chargement ignoré Changements de comportement
Le rappel FileConfigurationSource.OnLoadException est appelé pour les erreurs d’E/S Changements de comportement
IHost.RunAsync et IHost.StopAsync lèvent lorsqu’un BackgroundService échoue Changements de comportement
Le générateur de validation des options signale SYSLIB1205 pour les implémentations explicites de Validate Source non compatible
PhysicalFilesWatcher valide les chemins racine et les chemins de FileSystemWatcher Changements de comportement
Certains packages Microsoft.Extensions inclus dans le framework partagé Changements de comportement

Globalization

Titre Type de changement
Correction de la date minimale prise en charge du calendrier japonais Changements de comportement

Interopérabilité

Titre Type de changement
Native AOT rejette les signatures non blittables UnmanagedCallersOnly Changements de comportement
NativeAOT utilise le préfixe lib pour les sorties de bibliothèque natives sur Unix Changements de comportement

Compilateur JIT

Titre Type de changement
Les conversions à virgule flottante en petits types intégraux saturent Changements de comportement
Configuration matérielle minimale mise à jour Changements de comportement

Networking

Titre Type de changement
Les métriques de haute cardinalité HttpClient utilisent des compteurs observables Changements de comportement
Téléchargements de certificats AIA côté serveur SslStream désactivés par défaut Changements de comportement

.NET MAUI

Titre Type de changement
Android x86 n’est pas pris en charge Incompatibilité binaire/Changement de comportement
La génération de code sur mobile passe de Mono à CoreCLR Source incompatible/changement de comportement
CoreCLR remplace le runtime Mono pour les applications mobiles .NET Modification incompatible au niveau binaire ou du code source/Changement de comportement
Les événements de trace CoreCLR remplacent les événements de trace Mono Modification incompatible au niveau binaire ou du code source/Changement de comportement
Changements du comportement de signalement des incidents sur les plateformes mobiles Changements de comportement
Débogage d’interfaces sur des plateformes mobiles passant à ICorDebug Modification incompatible au niveau binaire ou du code source/Changement de comportement
Niveau minimal de l’API Android élevé à 24 Changements de comportement
Les API d’incorporation Mono ne sont plus prises en charge sur les plateformes mobiles Modification incompatible au niveau binaire ou du code source/Changement de comportement
Les propriétés de projet Mono ne configurent plus les applications mobiles Source incompatible/changement de comportement
Les paramètres de runtime Mono ne configurent plus les applications mobiles Incompatibilité comportementale/source
UnwindNativeCode n’est pas pris en charge sur les cibles Apple Source incompatible/changement de comportement

SDK et MSBuild

Titre Type de changement
Les scripts dnx contournent la sélection du Kit de développement logiciel (SDK) dans global.json Changements de comportement
cible de lancement mono non définie pour les applications .NET Framework Changements de comportement
Gestion des commandes CLI NativeAOT activée par défaut Changements de comportement
NU1703 avertit pour les packages qui utilisent des ressources d’infrastructure MonoAndroid dépréciées Source non compatible
Répertoire de verrous NuGet déplacé sur Linux Changements de comportement
NuGet pack avertit pour les ID de package contenant des caractères restreints Changements de comportement
La restauration ne recherche pas dans le dossier des packages globaux une version supérieure Source non compatible
La sélection du runtime de conteneur local du Kit de développement logiciel (SDK) privilégie les outils natifs de la plateforme Changements de comportement
Les packages de moteur de modèle ne prennent plus en charge netstandard2.0 Binaire/source incompatible
L’installation du package de modèle vérifie les signatures NuGet Changements de comportement
VSTest supprime la dépendance sur Newtonsoft.Json Binaire/source incompatible