Iron Suite for .NET

10 bibliothèques .NET. Une suite de documents complète.

NOUVELLES DE L'INDUSTRIE

Migration vers .NET 11 ? Vérifiez d'abord ces changements majeurs

Curtis Chau
Curtis Chau
Mis à jour : 31 août 2026

.NET 11 est proche, et la liste des changements majeurs est déjà disponible. Nous l'avons parcourue ligne par ligne pour que vous puissiez aborder la mise à niveau en sachant ce qu'il faut rechercher.

C'est une bonne nouvelle, mais cela rend également les tests de migration plus importants.

De nombreuses applications se compileront encore proprement après avoir été retargetées vers .NET 11. Le plus grand risque est le changement de comportement : un code qui se construit avec succès mais qui génère une nouvelle exception, gère les données différemment, ou produit des résultats légèrement différents à l'exécution.

Au lieu de passer en revue chaque élément de compatibilité un par un, ce guide se concentre sur les changements les plus susceptibles d'affecter les applications réelles et sur ce que vous devriez tester avant de passer en production.

Le tout en un tableau

ChangementCe qui se passe
Lecture ZIP valide CRC32Lève InvalidDataException sur les entrées corrompues
DateOnly/TimeOnly TryParseLève une exception sur un format ou un style invalide
Échec BackgroundServiceL'hôte lève une exception au démarrage/arrêt
Correction de Math.RoundRetourne des résultats correctement arrondis
Extensions dans le framework partagéLa résolution de la version de l'assembly peut changer
Outils de construction et de testChangements dans VSTest, NuGet, template-engine

Celui que nous vérifierions en premier : la lecture ZIP lève maintenant une exception

C'est le changement le plus susceptible de surprendre une base de code riche en documents, car il est silencieux jusqu'à ce qu'il ne le soit plus. À partir de .NET 11, System.IO.Compression valide le checksum CRC32 lorsque vous lisez une entrée ZIP, et lève InvalidDataException si le checksum stocké ne correspond pas aux données. Auparavant, une entrée corrompue ou altérée était lue sans aucune plainte.

C'est un changement vraiment positif, vous voulez savoir quand un fichier est mauvais, mais si votre application ingère des fichiers ZIP provenant d'utilisateurs, de partenaires ou d'un ancien stockage, un code qui "fonctionnait" depuis des années peut commencer à lever des exceptions. La solution est simple : enveloppez votre lecture dans un try-catch pour InvalidDataException et décidez comment vous souhaitez gérer une archive défectueuse. Mieux vaut l'attraper intentionnellement que de le découvrir en production.

Le sournois : TryParse peut maintenant lever une exception

Chaque développeur .NET a intégré que TryParse ne lève jamais d'exception, il retourne un booléen. Dans .NET 11, DateOnly.TryParse, TimeOnly.TryParse, et leurs TryParseExact homologues brisent légèrement cette habitude : passez une valeur DateTimeStyles invalide ou un mauvais spécificateur de format et ils lèvent maintenant ArgumentException au lieu de retourner tranquillement false. Si vos chaînes de format et styles sont codés en dur et valides, rien ne change. S'ils sont calculés à l'exécution ou proviennent de l'entrée utilisateur, c'est un nouveau chemin d'exception à couvrir.

Vérifiez seulement si c'est votre monde

Le reste est plus restreint, et regroupé par leur emplacement :

  • ASP.NET Core. Les anciennes API Blazor marquées obsolètes depuis des années ne se compilent plus. Kestrel est plus strict concernant les en-têtes HTTP mal formés. Et si votre chaîne de connexion SQL utilise l'authentification Entra ID (Active Directory), vous avez maintenant besoin du package Microsoft.Data.SqlClient.Extensions.Azure, cela concerne également les utilisateurs d'EF Core SQL Server.
  • Extensions et hébergement. Les services de travail échouent plus bruyamment : si un BackgroundService lève une exception, l'hôte lève aussi, donc testez votre chemin de démarrage.
  • Bibliothèques de base. Math.Round et les nombres complexes sont devenus plus conformes aux normes, ce qui n'a d'importance que si les tests attendent les anciennes valeurs.
  • Construction et outils. VSTest abandonne Newtonsoft.Json, les packages de modèles abandonnent netstandard2.0. Ceux-ci apparaissent comme des erreurs de construction, donc ils se manifestent d'eux-mêmes.
  • Plateforme. Les exigences minimales du CPU ont augmenté, .NET MAUI nécessite Android API 24, et la récupération des certificats côté serveur TLS est désactivée par défaut. Vous saurez si cela vous concerne.

Une chose dont vous n'aurez pas à vous soucier

Pendant que vous auditez les dépendances pour la préparation à .NET 11, vos outils de documentation ne devraient pas être sur la liste. Les bibliothèques de la Iron Suite sont purement gérées par .NET et fonctionnent déjà sur .NET 11 à travers .NET Framework, donc IronPDF, IronXL, et le reste de la suite se déplacent avec votre application au lieu de la bloquer. Cela vaut la peine d'être noté étant donné que le changement ZIP ci-dessus se situe juste à côté du type de code de gestion de fichiers que ces bibliothèques remplacent, si vous avez un traitement de documents ou d'archives fait maison, une migration est un moment naturel pour confier cette partie à une bibliothèque qui suit déjà chaque version de .NET.

Pour la liste complète, y compris les changements ASP.NET Core qui vivent sur leur propre page, la référence des changements majeurs de Microsoft .NET 11 est la source à mettre en favori. Nous mettrons à jour cet article à mesure que cette liste s'allonge, car elle est encore en cours de remplissage.