Iron Suite for .NET
10 bibliothèques .NET. Une suite de documents complète.
Migration vers .NET 11 ? Vérifiez d'abord ces changements majeurs
.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
| Changement | Ce qui se passe |
|---|---|
| Lecture ZIP valide CRC32 | Lève InvalidDataException sur les entrées corrompues |
DateOnly/TimeOnly TryParse | Lève une exception sur un format ou un style invalide |
Échec BackgroundService | L'hôte lève une exception au démarrage/arrêt |
| Correction de Math.Round | Retourne 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 test | Changements 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 packageMicrosoft.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
BackgroundServicelève une exception, l'hôte lève aussi, donc testez votre chemin de démarrage. - Bibliothèques de base.
Math.Roundet 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.