JSON till C#-klass

Exempel på utdata

För indatan:

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

System.Text.Json-utdata (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!;
}

Typmappning

Attributalternativ

• System.Text.Json ([JsonPropertyName("foo")]), att föredra för .NET 6+ och nya projekt.
• Newtonsoft.Json ([JsonProperty("foo")]), för äldre projekt eller när du behöver funktioner som är specifika för Newtonsoft.
• Inget, egenskapsnamnen matchar JSON-nycklarna exakt (fungerar bara om JSON-nycklarna redan är i PascalCase).

Vanliga misstag

• Att använda int för ett fält som kan spilla över. Om ditt JSON har värden som överstiger int.MaxValue, använd long. Generatorn uppgraderar automatiskt när den ser stora värden.
• Att glömma [JsonIgnore] för beräknade egenskaper. Om du lägger till hjälpegenskaper i den genererade klassen, dekorera dem med [JsonIgnore], annars serialiseras de vid utmatning.
• Att glömma kulturoberoende parsning. decimal-fält bör deserialiseras med CultureInfo.InvariantCulture; System.Text.Json gör detta som standard, Newtonsoft med globala inställningar.
• Att lita på generatorn utifrån ett enda exempel. Nullbarhet och array-elementens typer gissas utifrån det generatorn ser. Kontrollera alltid nullbara annoteringar mot ditt API:s faktiska beteende.