JSON zu C# Klasse

Beispielausgabe

Für die Eingabe:

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

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

Typzuordnung

Attributoptionen

• System.Text.Json ([JsonPropertyName("foo")]), bevorzugt für .NET 6+ und neue Projekte.
• Newtonsoft.Json ([JsonProperty("foo")]), für Legacy-Projekte oder wenn Sie spezifische Funktionen von Newtonsoft benötigen.
• Keine, Eigenschaftsnamen stimmen genau mit JSON-Schlüsseln überein (funktioniert nur, wenn JSON-Schlüssel bereits PascalCase sind).

Häufige Fehler

• Verwendung von int für ein Feld, das überlaufen könnte. Wenn Ihr JSON Werte hat, die int.MaxValue überschreiten, verwenden Sie long. Der Generator fördert automatisch, wenn er große Werte sieht.
• Fehlendes [JsonIgnore] für berechnete Eigenschaften. Wenn Sie Hilfseigenschaften zur generierten Klasse hinzufügen, dekorieren Sie diese mit [JsonIgnore], sonst werden sie beim Serialisieren ausgegeben.
• Vergessen der kulturunabhängigen Analyse. decimal-Felder sollten mit CultureInfo.InvariantCulture deserialisiert werden; System.Text.Json macht dies standardmäßig, Newtonsoft mit globalen Einstellungen.
• Vertrauen auf den Generator mit einem Beispiel. Nullbarkeit und Array-Elementtypen werden aus dem, was er sieht, geschätzt. Überprüfen Sie immer die nullable-Anmerkungen gegen das tatsächliche API-Verhalten.