JSON إلى class في C#‎

نبذة عن JSON إلى class في C#‎

تكتب أداة JSON إلى class في C#‎ تعريفات class للنماذج في C#‎ انطلاقا من عينة JSON أو من JSON Schema باستخدام quicktype-core، داخل متصفحك. يوضع الكود في مساحة الأسماء التي تختارها (App افتراضيا) مع عبارات using الخاصة بالمسلسل: System.Text.Json، مع سمة [JsonPropertyName] على كل خاصية، أو Newtonsoft.Json، مع [JsonProperty]. يصبح كل كائن متداخل تعريف class من نوع public partial، أو record إذا حددت «تعريفات record (C# 9 أو أحدث)»؛ ويأخذ تعريف المستوى الأعلى «اسم الفئة» (Root افتراضيا). تكتب الخصائص بصيغة PascalCase وتحتفظ كل منها بمفتاحها الأصلي في سمتها. الأعداد الصحيحة من نوع long، والأعداد العشرية من نوع double أو decimal، وتصبح المصفوفات مصفوفات مثل ‎Item[]‎ أو قوائم مثل List<Item>. الخصائص الغائبة عن بعض عناصر المصفوفة تكون nullable ولا تكتب عندما تكون قيمتها null. القيمة التي لها نوعان، مثل رقم في عنصر ونص في عنصر آخر، تضيف بنية اتحاد (struct) وفئات JsonConverter التي تحتاجها. يمكن لصق JSON أو فتحه من ملف ‎.json أو ‎.txt.

مثال

طلب شراء مع بنوده؛ الحقل note لا يظهر إلا في بند واحد، لذا يصبح nullable.

{"orderId": 1001, "total": 49.90, "paid": true,
 "items": [{"sku": "A1", "qty": 2}, {"sku": "B7", "qty": 1, "note": "gift"}]}

namespace App
{
    using System;
    using System.Collections.Generic;

    using System.Text.Json;
    using System.Text.Json.Serialization;
    using System.Globalization;

    public partial class Root
    {
        [JsonPropertyName("orderId")]
        public long OrderId { get; set; }

        [JsonPropertyName("total")]
        public double Total { get; set; }

        [JsonPropertyName("paid")]
        public bool Paid { get; set; }

        [JsonPropertyName("items")]
        public Item[] Items { get; set; }
    }

    public partial class Item
    {
        [JsonPropertyName("sku")]
        public string Sku { get; set; }

        [JsonPropertyName("qty")]
        public long Qty { get; set; }

        [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)]
        [JsonPropertyName("note")]
        public string? Note { get; set; }
    }
}

كيفية إنشاء تعريفات class في C#‎ من JSON

1. 1الصق عينة JSON في «مدخل JSON»، أو انقر على «فتح ملف» لتحميل ملف ‎.json أو ‎.txt. لاستخدام JSON Schema، اختر «JSON Schema» في «المصدر».
2. 2اختر «المسلسل»، ثم اكتب في «اسم الفئة» و«مساحة الأسماء» ما يستخدمه مشروعك.
3. 3انقر على «تحويل» للحصول على تعريفات class في «مخرج C#‎».
4. 4انقر على «نسخ»، أو على «تنزيل» لحفظ الكود في الملف «Model.cs».

الصيغ والحدود

الإدخال

كائن JSON أو مصفوفة كائنات، أو JSON Schema، ملصق أو مفتوح من ملف ‎.json أو ‎.txt

الإخراج

تعريفات class أو record في C#‎ داخل مساحة الأسماء التي تختارها (App افتراضيا)، محفوظة في Model.cs

المسلسل

System.Text.Json: سمة [JsonPropertyName] على كل خاصية، و[JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] على الخصائص الاختيارية؛ أو Newtonsoft.Json: سمة [JsonProperty]، مع NullValueHandling.Ignore على الخصائص الاختيارية

الأنواع

long، وdouble أو decimal، وbool، وstring، والمصفوفات (‎T[]‎) أو القوائم (List<T>)؛ object لمفتاح قيمته null في كل العينة؛ بنية اتحاد (struct) عندما يكون للقيمة نوعان؛ ومن JSON Schema أيضا تعدادات enum وDateTimeOffset

أين يعالج نص JSON الخاص بك

تنشأ تعريفات class بكود JavaScript يعمل على جهازك: لا يرفع نص JSON الذي تلصقه أو تفتحه، ولا كود C#‎ الناتج. تحمل مكتبة quicktype عند أول نقرة على «تحويل». عندما تعرض الصفحة خطأ، يتلقى سجل الأخطاء لدينا نصه، بعد حذف المقاطع المقتبسة والأرقام الطويلة وعناوين الويب والبريد الإلكتروني منه، مع اسم الأداة واسم متصفحك وإصداره.

الأسئلة الشائعة

نصائح وحيل

• ✓الصق مصفوفة فيها عدة عناصر حتى تصبح الخصائص الغائبة أحيانا nullable.
• ✓اختر decimal في «الأعداد العشرية» للأسعار والمبالغ: لا يستطيع double تمثيل قيم مثل 0.1 بدقة.

أدوات ذات صلة

• JSON إلى TypeScript
• JSON إلى struct في Go
• JSON إلى class في Python
• منسق JSON