Changements cassants dans .NET 6

  • Article
  • 6 minutes de lecture

Si vous migrez une application vers .NET 6, les changements cassants répertoriés ici peuvent vous concerner. Les changements sont groupés par domaine technologique, par exemple ASP.NET Core ou Windows Forms.

Cet article indique si chaque changement cassant est compatible binaire ou compatible avec la source :

  • Compatible binaire : les fichiers binaires existants se chargent et s’exécutent correctement sans recompilation et le comportement d’exécution ne change pas.
  • Compatible avec la source : le code source se compile correctement sans changement lors du ciblage du nouveau runtime ou de l’utilisation du nouveau Kit de développement logiciel (SDK) ou composant.

Notes

Cet article n’est pas définitif. Il ne s’agit pas d’une liste complète des changements cassants dans .NET 6. Pour interroger les changements cassants qui sont toujours en attente de publication, consultez Problèmes .NET.

ASP.NET Core

Titre Compatible binaire Compatible avec la source Introduit
ActionResult<T> définit StatusCode sur 200 ✔️ ❌
Méthode AddDataAnnotationsValidation rendue obsolète ✔️ ❌
Assemblys supprimés de l’infrastructure partagée Microsoft.AspNetCore.App ❌ ✔️
Blazor : nom du paramètre modifié dans la méthode RequestImageFileAsync ✔️ ❌ Preview 1
Blazor : propriété WebEventDescriptor.EventArgsType remplacée ❌ ❌
Blazor : interopérabilité du tableau d’octets ✔️ ❌ Préversion 6
Changed MessagePack library in @microsoft/signalr-protocol-msgpack ❌ ✔️
La propriété ClientCertificate ne déclenche pas de renégociation pour HttpSys ✔️ ❌
Les métadonnées de EndpointName ne sont pas définies automatiquement ✔️ ❌ RC 2
Identité : la version Bootstrap par défaut de l’interface utilisateur a été modifiée ❌ ❌
Kestrel : les attributs de message de journal ont été modifiés ✔️ ❌
FRactionnement de Microsoft.AspNetCore.Http.Features ❌ ✔️
Intergiciel : l’intergiciel de redirection HTTPS lève une exception sur les ports HTTPS ambigus ✔️ ❌
Intergiciel : surcharge de nouvelle utilisation ✔️ ❌ Preview 4
Renommages des API minimales dans RC 1 ❌ ❌ RC 1
Renommages des API minimales dans RC 2 ❌ ❌ RC 2
MVC ne met pas en mémoire tampon les types IAsyncEnumerable lors de l’utilisation de System.Text.Json ✔️ ❌ Preview 4
Changement des annotations de type de référence Nullable ✔️ ❌
API obsolètes et supprimées ✔️ ❌ Preview 1
PreserveCompilationContext non configuré par défaut ❌ ✔️
Razor : le compilateur ne produit plus d’assembly d’affichages ✔️ ❌ Preview 3
Razor : changements des ID de journalisation ❌ ✔️ RC1
Razor : RazorAPI de moteur marquées comme obsolètes ✔️ ❌ Preview 1
SignalR : Client Java mis à jour vers RxJava3 ❌ ✔️ Preview 4
Les méthodes TryParse et BindAsync sont validées ❌ ❌ RC 2

Conteneurs

Titre Compatible binaire Compatible avec la source Introduit
Mise en forme de l’enregistreur d’événements de console par défaut dans les images conteneur ✔️ ❌ Maintenance 6.0.6

Pour plus d’informations sur d’autres changements cassants pour les conteneurs dans .NET 6, consultez Notes de publication du conteneur .NET 6.

Bibliothèques .NET Core

Titre Compatible binaire Compatible avec la source Introduit
Obsolescence d’API avec ID de diagnostics autres que ceux par défaut ✔️ ❌ Preview 1
Changement des annotations de type de référence Nullable ✔️ ❌ Préversion 1-2
Évaluation de chaîne conditionnelle dans les méthodes de débogage ✔️ ❌ RC 1
Comportement d’Environment.ProcessorCount sur Windows ✔️ ❌ Préversion 2
File.Replace sur Unix lève des exceptions pour correspondre à Windows ✔️ ❌ Préversion 7
FileStream verrouille les fichiers avec un verrou partagé sur Unix ❌ ✔️ Preview 1
FileStream ne synchronise plus le décalage de fichier avec le système d’exploitation ❌ ❌ Preview 4
Mises à jour de FileStream.Position après la finalisation de ReadAsync ou de WriteAsync ❌ ❌ Preview 4
Nouveaux ID de diagnostic pour les API obsolètes ✔️ ❌ Préversion 5
Nouvelle annotation nullable dans AssociatedMetadataTypeTypeDescriptionProvider ✔️ ❌ RC 2
Nouvelles surcharges de méthodes System.Linq.Queryable ✔️ ❌ Préversion 3-4
Versions antérieures de l’infrastructure supprimées du package ❌ ✔️ Préversion 5
Noms de paramètres modifiés ✔️ ❌ Preview 1
Noms de paramètres dans les types dérivés du flux ✔️ ❌ Preview 1
Lectures de ligne de code partiellement exécutée et à zéro octet dans DeflateStream, GZipStream et CryptoStream ✔️ ❌ Préversion 6
Définir le timestamp sur un fichier en lecture seule sur Windows ❌ ✔️ Maintenance 6.0.2
Précision de l’analyse de format numérique standard ✔️ ❌ Préversion 2
Membres abstraits statiques dans les interfaces ❌ ✔️ Préversion 7
Surcharges et ordre d’évaluation de StringBuilder.Append ❌ ✔️ RC 1
Les API avec nom fort lèvent l’exception PlatformNotSupportedException ❌ ✔️ Preview 4
System.Drawing.Common uniquement pris en charge sur Windows ❌ ❌ Préversion 7
System.Security.SecurityContext est marqué comme obsolète ✔️ ❌ RC 1
Task.FromResult peut retourner un singleton ❌ ✔️ Preview 1
Exceptions non prises en charge d’un BackgroundService ✔️ ❌ Preview 4

Chiffrement

Titre Compatible binaire Compatible avec la source Introduit
Les méthodes CreateEncryptor lèvent une exception en cas de taille de commentaires incorrecte ❌ ✔️ Préversion 7

Déploiement

Titre Compatible binaire Compatible avec la source Introduit
Chemin d’accès à l’hôte x86 sur Windows 64 bits ✔️ ✔️ Version de maintenance

Entity Framework Core

Changements cassants dans EF Core 6

Extensions

Titre Compatible binaire Compatible avec la source Introduit
AddProvider recherche un fournisseur non null ✔️ ❌ RC 1
FileConfigurationProvider.Load lève InvalidDataException ✔️ ❌ RC 1
Les éléments XML répétés incluent un index ❌ ✔️
Résolution de la levée d’exceptions par un ServiceProvider supprimé ✔️ ❌ RC 1

Globalisation

Titre Compatible binaire Compatible avec la source Introduit
Création de culture et mappage d’incidents en mode invariant de globalisation Préversion 7

Interop

Titre Compatible binaire Compatible avec la source Introduit
Membres abstraits statiques dans les interfaces ❌ ✔️ Préversion 7

Compilateur JIT

Titre Compatible binaire Compatible avec la source Introduit
Forcer les arguments d’appel selon ECMA-335 ✔️ ✔️ Preview 1

Mise en réseau

Titre Compatible binaire Compatible avec la source Introduit
Port supprimé du SPN pour Kerberos et par négociation ❌ ✔️ RC 1
WebRequest, WebClient et ServicePoint sont obsolètes ✔️ ❌ Preview 1

Kit SDK

Titre Compatible binaire Compatible avec la source Introduit
L'option -p pour dotnet run est déconseillée ✔️ ❌ Préversion 6
Code C# dans les modèles non pris en charge par les versions antérieures ✔️ ✔️ Préversion 7
Fichiers EditorConfig implicitement inclus ✔️ ❌
Générer apphost pour macOS ✔️ ❌ Préversion 6
Générer une erreur en cas de fichiers en double dans la sortie de publication ❌ ✔️ Preview 1
Suppression de GetTargetFrameworkProperties et de GetNearestTargetFramework du protocole ProjectReference ❌ ✔️ Preview 1
Emplacement d’installation pour x64 émulé sur ARM64 ✔️ ❌ RC 2
MSBuild ne prend plus en charge l’appel de GetType() RC 1
OutputType n’est pas automatiquement défini sur WinExe ✔️ ❌ RC 1
Publier ReadyToRun avec ---no-restore nécessite des changements ✔️ ❌ 6.0.100
Fichier runtimeconfig.dev.json non généré ❌ ✔️ 6.0.100
Avertissement RuntimeIdentifier si l’autonome n’est pas spécifié ✔️ ❌ RC 1
Exigences de version pour le Kit de développement logiciel (SDK) .NET 6 ✔️ ✔️ 6.0.300
Le fichier .version inclut la version de build ✔️ ✔️ 6.0.401
Écrire des assemblys de référence dans IntermediateOutputPath ❌ ✔️ 6.0.200

Sérialisation

Titre Compatible binaire Compatible avec la source Introduit
DataContractSerializer conserve le signe lors de la désérialisation de -0 ❌ ✔️ Maintenance 6.0.11
Format de sérialisation par défaut pour TimeSpan ❌ ✔️ Maintenance 6.0.2
Sérialisation IAsyncEnumerable ✔️ ❌ Preview 4
Refactorisation de l’API de génération de source JSON ❌ ✔️ RC 2
JsonNumberHandlingAttribute sur les propriétés d’une collection ❌ ✔️ RC 1
Nouvelles surcharges du générateur de source JsonSerializer ❌ ✔️ Préversion 6

Windows Forms

Titre Compatible binaire Compatible avec la source Introduit
Les modèles C# utilisent le démarrage d’application ✔️ ❌ RC 1
Les propriétés TableLayoutSettings sélectionnées lèvent InvalidEnumArgumentException ❌ ✔️ Preview 1
Les API liées à DataGridView lèvent désormais InvalidOperationException ❌ ✔️ Preview 4
Les méthodes ListViewGroupCollection lèvent une nouvelle exception InvalidOperationException ❌ ✔️ RC 2
Augmentation de la longueur de texte maximale de NotifyIcon.Text ❌ ✔️ Preview 1
ScaleControl appelé uniquement quand cela est nécessaire ✔️ ❌ Maintenance 6.0.101
Certaines API lèvent une exception ArgumentNullException ❌ ✔️ Préversion 1-4
TreeNodeCollection.Item lève une exception si le nœud est affecté ailleurs ❌ ✔️ Preview 1

XML et XSLT

Titre Compatible binaire Compatible avec la source Introduit
Changement de nullabilité de XmlDocument.XmlResolver ❌ ✔️ RC 1
Comportement de XNodeReader.GetAttribute pour un index non valide ✔️ ❌ Préversion 2

Voir aussi