تحويل JSON إلى فئة C#

مثال على الناتج

للمدخل التالي:

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

ناتج 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!;
}

تعيين الأنواع

خيارات السمات

• System.Text.Json ([JsonPropertyName("foo")])، يُفضّل استخدامه في مشاريع .NET 6+ والمشاريع الجديدة.
• Newtonsoft.Json ([JsonProperty("foo")])، للمشاريع القديمة أو عندما تحتاج إلى ميزات خاصة بـ Newtonsoft.
• بدون، تتطابق أسماء الخصائص تمامًا مع مفاتيح JSON (يعمل هذا الخيار فقط إذا كانت مفاتيح JSON بنمط PascalCase مسبقًا).

أخطاء شائعة

• استخدام int لحقل قد يتجاوز الحد. إذا احتوت بيانات JSON على قيم تتجاوز int.MaxValue، فاستخدم long. يرفع المولّد النوع تلقائيًا عندما يرصد قيمًا كبيرة.
• إغفال [JsonIgnore] للخصائص المحسوبة. إذا أضفت خصائص مساعِدة إلى الفئة المولَّدة، فزيّنها بالسمة [JsonIgnore]؛ وإلا فسيتم تسلسلها عند الإخراج.
• نسيان التحليل المستقل عن الثقافة. ينبغي إلغاء تسلسل حقول decimal باستخدام CultureInfo.InvariantCulture؛ يفعل System.Text.Json ذلك افتراضيًا، بينما يفعله Newtonsoft عبر الإعدادات العامة.
• الوثوق بالمولّد اعتمادًا على عيّنة واحدة فقط. يُستنتج احتمال الإبطال وأنواع عناصر المصفوفة مما يراه المولّد. تحقّق دائمًا من صحة تعليقات القابلية للإبطال مقارنةً بالسلوك الفعلي لواجهة برمجة التطبيقات لديك.