JSON vers C#
Générez des classes C# pour System.Text.Json à partir d’un exemple JSON. Chaque propriété reçoit un attribut JsonPropertyName contenant la clé d’origine et un nom en PascalCase. Les clés présentes dans chaque exemple sont marquées comme obligatoires ; les valeurs nullables et facultatives utilisent des types nullables, et les tableaux deviennent des List. Les valeurs de types mixtes deviennent des JsonElement.
Foire aux questions
Comment les objets imbriqués sont-ils nommés ?
Chaque objet imbriqué devient son propre type C#, nommé d’après la clé qui le contient en PascalCase : ainsi, address devient Address. Les objets dans des tableaux prennent le singulier de la clé du tableau : ainsi, users devient User. Les objets qui ont exactement les mêmes champs partagent un type.
Quand un champ est-il facultatif ?
Lorsqu’un tableau contient plusieurs objets et qu’une clé manque dans certains d’entre eux, le champ correspondant est facultatif : il n’a pas de modificateur required et son type devient nullable. Une clé présente dans chaque exemple est obligatoire. Un objet seul ne permet aucune comparaison : toutes ses clés sont donc obligatoires.
Comment les valeurs null sont-elles traitées ?
Une clé qui vaut null dans certains exemples et contient une valeur dans d’autres devient un type nullable, comme string?. Une clé qui vaut toujours null ne donne aucune indication sur son type réel : elle devient donc JsonElement?. Collez un exemple contenant une valeur réelle pour obtenir un type précis.
Quels types sont utilisés pour les nombres ?
Les nombres entiers deviennent des long et les nombres décimaux des double. Un champ qui contient les deux devient un double.
Que deviennent les clés qui ne sont pas des noms valides ?
Les noms des propriétés sont reconstruits en PascalCase et l’attribut JsonPropertyName conserve la clé d’origine : first-name devient ainsi FirstName, tout en continuant à lire first-name. Un numéro est ajouté à une propriété qui aurait le même nom que sa classe, car C# ne l’autorise pas.
Mon JSON est-il téléversé ou stocké ?
Le JSON est envoyé au serveur uniquement pour générer le code correspondant à cette requête et n’est pas stocké. Le générateur ne lit que la structure et les types de valeurs de votre exemple. Vous pouvez donc remplacer les valeurs sensibles par des espaces réservés du même type avant de le coller.