JSON ke Kelas C#

Contoh hasil eksekusi

Untuk masukan:

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

Keluaran 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!;
}

Pemetaan Tipe

Opsi atribut

• System.Text.Json ([JsonPropertyName("foo")]), lebih disarankan untuk .NET 6+ dan proyek-proyek baru.
• Newtonsoft.Json ([JsonProperty("foo")]), digunakan untuk proyek lama atau ketika Anda memerlukan fitur khusus Newtonsoft.
• Tidak ada, nama properti sesuai persis dengan kunci JSON (hanya berlaku jika kunci JSON sudah menggunakan format PascalCase).

Kesalahan Umum

• Gunakan int untuk bidang yang berpotensi melebihi batas nilai. Jika JSON Anda mengandung nilai yang melebihi batas int.MaxValue, gunakan long. Generator akan secara otomatis beralih ke format long ketika mendeteksi nilai yang besar.
• [JsonIgnore] tidak tersedia untuk properti komputasi. Jika Anda menambahkan properti bantu ke kelas yang dihasilkan, hiasi properti tersebut dengan [JsonIgnore]; jika tidak, properti tersebut akan diserialisasi saat proses penghasilan kelas selesai. – Mengabaikan proses pemrosesan data yang tidak bergantung pada konteks budaya (culture-invariant parsing). Field dari decimal seharusnya dideserialisasi menggunakan CultureInfo.InvariantCulture; hal ini dilakukan secara default oleh System.Text.Json dan juga oleh Newtonsoft dengan pengaturan global.
• Mengandalkan generator hanya dengan satu sampel. Kemampuan untuk menghasilkan nilai nol (nullability) dan tipe elemen array diperkirakan berdasarkan data yang dilihatnya. Selalu lakukan pemeriksaan keabsahan terhadap anotasi nullable sesuai dengan perilaku API yang sebenarnya.