Guide pratique

Convertisseur JSON vers classes C# — Guide d’utilisation et principes techniques

Transformez vos charges JSON en classes C# fortement typées avec JsonPropertyName, Support des références nullables et un code parfaitement Formaté.

Ouvrir l’outil

Présentation

Les applications .NET consomment du JSON partout : API REST, événements cloud, configuration, télémétrie ou Fichiers de messages. Générer automatiquement des classes C# fortement typées apporte sécurité de compilation, IntelliSense clair, modèles métiers plus lisibles et refactoring serein. JsonPropertyName conserve les clés d’origine et facilite les échanges contractuels entre équipes.

Concepts clés

Correspondance JSON → C#

Les chaînes deviennent string ou DateTime (si ISO-8601), les entiers long, les valeurs décimales double, les booléens bool, les objets des classes dédiées et les tableaux des Liste<T>. Dès qu’un null est rencontré, la propriété devient nullable et, si l’option est Actif, le suffixe ? est appliqué. Les tableaux hétérogènes basculent vers Liste<object> pour conserver toute la structure.

Pipeline de génération

Le Convertisseur parcourt récursivement le JSON pour construire des signatures de classe réutilisables. Les noms de propriétés sont normalisés en PascalCase tout en évitant les mots réservés C#. Les formes identiques partagent la même classe et les tableaux réutilisent le Type d’élément inféré. Un tableau de bord affiche le nombre de classes, de propriétés et de tableaux afin d’évaluer la complexité du modèle en un coup d’œil.

JsonPropertyName et sérialisation

System.Text.Json s’appuie sur JsonPropertyName pour mapper les clés : l’outil peut donc décorer chaque propriété avec la clé d’origine, ce qui facilite la consommation de payloads snake_case depuis des propriétés PascalCase. Comme les classes générées sont partial, vous pouvez ajouter vos validations ou convertisseurs dans d’autres fichiers sans modifier le code généré.

Stratégie nullable

Lorsque les références nullables sont activées, toutes les valeurs susceptibles d’être null (bool, long, double, string, Liste<T>, classes imbriquées, etc.) reçoivent automatiquement un ?. Vous obtenez ainsi des avertissements de compilation clairs et vous réduisez drastiquement les NullReferenceException en production.

Fonctionnalités

Sortie fortement typée

Types C# précis, classes imbriquées et respect des conventions PascalCase tout en conservant les clés d’origine.

Support JsonPropertyName

Assurez la compatibilité System.Text.Json pour les payloads snake_case grâce aux attributs JsonPropertyName.

Sensibilité aux null

Ajoutez automatiquement ? lorsque la valeur peut être null et rendez vos modèles plus sûrs.

Statistiques intégrées

Affichage immédiat du nombre de classes, propriétés et tableaux pour juger la complexité.

Questions fréquentes

Qu'est-ce que la génération de classes C# à partir de JSON et pourquoi est-ce utile ?

La génération de classes C# à partir de JSON crée automatiquement des classes C# fortement typées à partir de structures de données JSON. C'est essentiel lors du travail avec des API, des fichiers de configuration ou la sérialisation de données dans des applications .NET. Au lieu d'écrire manuellement des classes ou d'utiliser des Types dynamiques, le générateur crée des classes C# appropriées avec des Types corrects, le Support nullable et les attributs JsonPropertyName, économisant des heures de développement et réduisant les erreurs.

Commentaire le générateur gère-t-il les différents Types de données JSON ?

Le générateur mappe les Types JSON vers des Types C# appropriés : les chaînes deviennent string ou DateTime (pour les Dates ISO-8601), les entiers mappent vers long, les nombres à virgule flottante vers double, les booléens vers bool, les objets deviennent des classes dédiées et les tableaux deviennent Liste<T>. Les valeurs null marquent les propriétés comme nullable (avec le suffixe ? lorsque les références nullable sont activées). Les tableaux mixtes utilisent Liste<object> pour préserver les données hétérogènes.

Que sont les attributs JsonPropertyName et quand les utiliser ?

Les attributs JsonPropertyName permettent aux propriétés C# d'utiliser la nomenclature PascalCase (convention C#) tandis que le JSON utilise une nomenclature différente (comme snake_case ou camelCase). L'attribut préserve le nom de clé JSON original lors de la sérialisation/désérialisation. Activez cette option lorsque votre JSON utilise des clés non-PascalCase mais que vous souhaitez des noms de propriétés C# idiomatiques dans votre code.

Qu'est-ce que le Support des références nullable et pourquoi l'activer ?

Les Types de référence nullable (C# 8.0+) ajoutent ? aux Types de référence lorsqu'ils peuvent être null, activant la vérification null à la compilation. Lorsqu'il est activé, le générateur ajoute ? aux propriétés lorsque l'échantillon JSON contient des valeurs null. Cela aide à prévenir les erreurs NullReferenceException, rend les champs optionnels explicites et suit les meilleures pratiques C# modernes pour la sécurité null.

Puis-je modifier les classes générées après la génération ?

Oui, le générateur crée des classes partielles par défaut (ou lorsqu'activé), vous permettant de les étendre dans des fichiers séparés sans modifier le code généré. Vous pouvez ajouter des méthodes personnalisées, une logique de validation, des attributs spécifiques au domaine ou implémenter des interfaces. Cette séparation maintient le code généré propre et permet de régénérer en toute sécurité les classes lorsque la structure JSON change.

Documentation associée

Convertisseur JSON vers classes C#

Ouvrez l’outil pour essayer ces fonctionnalités.

Ouvrir l’outil