توليد أصناف C# و Record مع Newtonsoft و System.Text.Json

مولِّد JSON → C# Class يحوِّل عيِّنة JSON إلى أصناف كيانات C#، ويدعم صياغة الخصائص التلقائية (auto-property) وتوضيحات [JsonProperty] الاختيارية (Newtonsoft.Json). يناسب مجموعة واسعة من بيئات C# بما فيها .NET Core و ASP.NET و WPF و Unity، وهو مساعد فعال عند التكامل مع واجهات REST API أو طوابير الرسائل.

الخطوة 1 — أدخل عيِّنة JSON على اليسار أو انقر "Sample" لتحميل حمولة مسبقة الإعداد. الخطوة 2 — املأ مساحة الأسماء (مثلاً MyApp.Models) واسم الصنف الجذري (الافتراضي RootObject). الخطوة 3 — اختر ما إذا كنت ستستخدم صياغة الخصائص التلقائية (يُوصى بذلك) وما إذا كنت ستضيف [JsonProperty] للتحكم الدقيق في الأسماء المُتسلسلة. الخطوة 4 — يُحدِّث المحرر الأيمن كود C# في الوقت الفعلي؛ انسخه أو نزِّله كملف .cs. تُقسَّم كائنات JSON المتداخلة تلقائياً إلى أصناف متعددة وتُدمج عناصر المصفوفات.

يقوم مطورو ASP.NET Core Web API بإنشاء نماذج الطلب / الاستجابة من العقود المتفق عليها؛ تولِّد مشاريع Unity للألعاب أصناف الإعدادات أو البروتوكولات بسرعة عند التواصل مع خادم خلفي؛ تحتاج تطبيقات سطح المكتب (WPF / WinForms) نماذج قوية الأنواع بعد جلب بيانات REST؛ اقتناص العيِّنات من توثيق Swagger / OpenAPI للاستيراد بالجملة؛ تحويل أشكال إعدادات JSON إلى أصناف Options للعمل مع نمط IOptions<T>.

تُطابَق السلاسل إلى string، والأعداد الصحيحة إلى int، والأعداد العشرية إلى double، والقيم المنطقية إلى bool، والمصفوفات إلى List<T>، وتصبح القيم المختلطة أو null من نوع object. أسماء الأصناف بصيغة PascalCase وتتبع أسماء الخصائص أعراف C#. لاستخدام [JsonProperty]، استورد using Newtonsoft.Json; أو التوضيح المكافئ في System.Text.Json وهو [JsonPropertyName]. المسافة البادئة الافتراضية للكود المولَّد 4 مسافات ويمكن تبديلها إلى 2.

تجري عملية توليد الأصناف بأكملها محلياً في متصفحك. لا يُرفع JSON الذي تُدخله أبداً، فتستطيع استخدامه بأمان لنمذجة كيانات واجهات API الداخلية للأعمال.