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