JSON vers classe C#

Exemple de sortie

Pour l’entrée :

{ "firstName": "Alice", "age": 30, "emails": ["a@a.com"], "address": { "city": "Madrid" } }

Sortie System.Text.Json (C# 10+) :

public class User
{
    [JsonPropertyName("firstName")]
    public string FirstName { get; set; } = default!;

    [JsonPropertyName("age")]
    public int Age { get; set; }

    [JsonPropertyName("emails")]
    public List<string> Emails { get; set; } = new();

    [JsonPropertyName("address")]
    public Address Address { get; set; } = default!;
}

public class Address
{
    [JsonPropertyName("city")]
    public string City { get; set; } = default!;
}

Mappage des types

Options d’attributs

• System.Text.Json ([JsonPropertyName("foo")]), préféré pour .NET 6+ et nouveaux projets.
• Newtonsoft.Json ([JsonProperty("foo")]), pour les projets hérités ou lorsque vous avez besoin de fonctionnalités spécifiques à Newtonsoft.
• Aucun, les noms de propriétés correspondent exactement aux clés JSON (ne fonctionne que si les clés JSON sont déjà en PascalCase).

Erreurs courantes

• Utiliser int pour un champ qui pourrait déborder. Si votre JSON a des valeurs qui dépassent int.MaxValue, utilisez long. Le générateur promeut automatiquement lorsqu’il voit de grandes valeurs.
• Oublier [JsonIgnore] pour les propriétés calculées. Si vous ajoutez des propriétés d’aide à la classe générée, décorez-les avec [JsonIgnore] ou elles seront sérialisées lors de la sortie.
• Oublier l’analyse indépendante de la culture. Les champs decimal doivent être désérialisés avec CultureInfo.InvariantCulture; System.Text.Json le fait par défaut, Newtonsoft avec des paramètres globaux.
• Faire confiance au générateur avec un seul exemple. La nullabilité et les types d’éléments de tableau sont devinés à partir de ce qu’il voit. Vérifiez toujours les annotations nullable par rapport au comportement réel de votre API.