🧩

Convertisseur JSON vers classes C#

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

Guide pratique
Paramètres
Nom de la classe
Nom attribué à la classe C# racine générée
Ajouter JsonPropertyName
Garder la casse d’origine des clés via JsonPropertyName("key")
Activer les références nullables
Ajouter automatiquement ? lorsque le JSON peut contenir null
Générer des partial class
Marquer chaque classe comme partial pour les étendre ailleurs

Saisir le JSON

JSON valide

❓Pourquoi convertir JSON en C# ?

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.

✨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é.

📚Guide pratique

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.

💬Frequently Asked Questions

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

💡Bonnes pratiques

💡

Fournir un échantillon représentatif

Incluez les sections optionnelles et les null pour que les informations nullable soient correctes.
🧱

Découper les gros payloads

Convertissez les segments séparément puis regroupez-les via des partial class dans votre solution.
🧾

Nettoyer le JSON

Supprimez commentaires et virgules finales afin d’éviter les erreurs de parsing.

📝Journal des mises à jour

📌v1.0.251115
v1.0.251115

Première version avec bascule JsonPropertyName, gestion nullable, panneau de statistiques et export .cs

📦Composants recommandés

User Comments

0 / 2000
Loading...