JSON'ten C# Sınıfına

Örnek Çıkış

Giriş için:

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

System.Text.Json çıktısı (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!;
}

Tür Haritalaması

Öznitelik seçenekleri

• System.Text.Json ([JsonPropertyName("foo")]). NET 6+ ve yeni projeler için tercih edilir.
• Newtonsoft.Json ([JsonProperty("foo")]), eski projeler için veya Newtonsoft’a özgü özelliklere ihtiyaç duyulduğunda kullanılır.
• Yok, özellik adları JSON anahtarlarıyla tam olarak eşleşir (yalnızca JSON anahtarları zaten PascalCase ise geçerlidir).

Yaygın Hatalar

• Taşabilecek bir alan için int kullanmak. JSON’unuzdaki değerler int.MaxValue’yi aşıyorsa long kullanın. Jeneratör büyük değerleri gördüğünde türü otomatik olarak yükseltir.
• Hesaplanan özellikler için [JsonIgnore] eksik. Üretilen sınıfa yardımcı özellikler eklerseniz, bunları [JsonIgnore] ile belirleyin; aksi takdirde serielleştirme işlemi sırasında bu özellikler silinecektir.
• Kültüre bağımsız analizi unutmak: decimal alanları CultureInfo.InvariantCulture ile deserialize edilmelidir; System.Text.Json bunu varsayılan olarak yapar, Newtonsoft ise küresel ayarlar kullanılarak bu işlemi gerçekleştirir.
• Tek bir örnekle jeneratöre güvenmek. Boş değer alabilirlik ve dizi öğesi türleri, jeneratörün gördüğü verilerden tahmin edilir. Boş değer alabilirlik ek açıklamalarının makul olup olmadığını her zaman gerçek API davranışınızla karşılaştırarak kontrol edin.