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 perturbateur du comportement, tel qu’un échec de chargement ou d’exécution, et, le cas échéant, nécessiter une recompilation.

  • Source incompatible : lorsqu’il est recompilé à l’aide du nouveau kit de développement logiciel (SDK) ou du nouveau composant ou pour cibler le nouveau runtime, le code source existant peut nécessiter des modifications de source pour réussir la compilation.

  • 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.

Bibliothèques de .NET principales

Titre Type de changement
Validation CRC32 ajoutée lors de la lecture des entrées d’archive ZIP Changements de comportement
Méthodes DateOnly et TimeOnly TryParse levées pour une entrée non valide Changements de comportement
DeflateStream et GZipStream écrivent des en-têtes et pieds de page pour une charge utile vide Changements de comportement
Environment.TickCount est rendu cohérent avec le comportement de délai d'expiration de Windows Changements de comportement
MemoryStream : la capacité maximale mise à jour et le comportement d'exception modifié Changements de comportement
Obsolescence d’API avec ID de diagnostics autres que ceux par défaut (.NET 11) Source non compatible
LES API de lecture de TAR vérifient les sommes de contrôle d’en-tête lors de la lecture Changements de comportement
ZipArchive.CreateAsync charge avec impatience les entrées d’archive ZIP Changements de comportement

Cryptography

Titre Type de changement
DSA supprimé de macOS Changements de comportement

Extensions

Titre Type de changement
IHost.RunAsync et IHost.StopAsync lèvent lorsqu’un BackgroundService échoue Changements de comportement

Globalization

Titre Type de changement
Date minimale prise en charge du calendrier japonais corrigé Changements de comportement

Interopérabilité

Titre Type de changement
NativeAOT utilise le préfixe lib pour les sorties de bibliothèque natives sur Unix Changements de comportement

Compilateur JIT

Titre Type de changement
Configuration matérielle minimale requise mise à jour Changements de comportement

SDK et MSBuild

Titre Type de changement
objectif de lancement mono non défini pour les applications .NET Framework Changements de comportement