JSON naar C#-klasse

Voorbeelduitvoer

Voor de invoer:

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

Uitvoer van 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!;
}

Typetoewijzing

Attribuutopties

• System.Text.Json ([JsonPropertyName("foo")]), aanbevolen voor .NET 6+ en nieuwe projecten.
• Newtonsoft.Json ([JsonProperty("foo")]), voor legacy-projecten of wanneer je functies nodig hebt die specifiek zijn voor Newtonsoft.
• Geen, de eigenschapsnamen komen exact overeen met de JSON-sleutels (werkt alleen als de JSON-sleutels al in PascalCase staan).

Veelvoorkomende fouten

• int gebruiken voor een veld dat kan overlopen. Als je JSON waarden bevat die groter zijn dan int.MaxValue, gebruik dan long. De generator schakelt automatisch op wanneer hij grote waarden ziet.
• [JsonIgnore] vergeten voor berekende eigenschappen. Als je hulp-eigenschappen aan de gegenereerde klasse toevoegt, voorzie ze dan van [JsonIgnore], anders worden ze bij het serialiseren mee weggeschreven.
• Cultuuronafhankelijke parsing vergeten. decimal-velden horen te worden gedeserialiseerd met CultureInfo.InvariantCulture; System.Text.Json doet dit standaard, Newtonsoft via globale instellingen.
• De generator vertrouwen op basis van één voorbeeld. Nullbaarheid en de typen van array-elementen worden afgeleid uit wat de generator ziet. Controleer nullbare annotaties altijd tegen het werkelijke gedrag van je API.