# تحويل JSON إلى C#

أنشئ أصناف C# لـ System.Text.Json من عينة JSON. تحصل كل خاصية على السمة JsonPropertyName مع المفتاح الأصلي واسم بصيغة PascalCase. وتُعلّم المفاتيح الموجودة في كل العينات بأنها مطلوبة، بينما تستخدم القيم الاختيارية والقابلة لأن تكون null أنواعًا قابلة لأن تكون null، وتتحول المصفوفات إلى List. أما القيم متعددة الأنواع فتتحول إلى JsonElement.

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

### كيف تُسمّى الكائنات المتداخلة؟

يتحول كل كائن متداخل إلى نوع C# مستقل، ويُسمّى باسم المفتاح الذي يحتويه بصيغة PascalCase؛ مثلًا، يتحول address إلى Address. وتتخذ الكائنات داخل المصفوفات الاسم المفرد لمفتاح المصفوفة؛ مثلًا، يتحول users إلى User. أما الكائنات ذات الحقول المتطابقة تمامًا فتشترك في نوع واحد.

### متى يكون الحقل اختياريًا؟

عندما تحتوي مصفوفة على عدة كائنات ويغيب مفتاح في بعضها، يكون ذلك الحقل اختياريًا: لا يحصل على معدِّل required ويصبح نوعه قابلًا لأن يكون null. أما المفتاح الموجود في كل العينات فهو مطلوب. ولا يوجد ما تقارنه به في الكائن المنفرد، لذا تكون كل مفاتيحه مطلوبة.

### كيف تُعالَج القيم null؟

يتحول المفتاح الذي تكون قيمته null في بعض العينات وله قيمة في غيرها إلى نوع قابل لأن يكون null، مثل string?. أما المفتاح الذي تكون قيمته null دائمًا فلا يتيح للأداة معرفة نوعه الحقيقي، لذا يصبح JsonElement?؛ ألصق عينة تتضمن قيمة فعلية للحصول على نوع دقيق.

### ما أنواع الأرقام المستخدمة؟

تتحول الأعداد الصحيحة إلى long، والأعداد ذات الكسور إلى double. وإذا احتوى حقل على النوعين، فإنه يصبح double.

### ماذا يحدث للمفاتيح التي ليست أسماء صالحة؟

تُعاد صياغة أسماء الخصائص باستخدام PascalCase، وتحافظ السمة JsonPropertyName على المفتاح الأصلي؛ لذا يتحول first-name إلى FirstName مع استمرار قراءته على أنه first-name. وتُضاف قيمة رقمية إلى اسم الخاصية إذا كان سيطابق اسم صنفها، لأن C# لا يسمح بذلك.

### هل يتم تحميل JSON الخاص بي أو تخزينه؟

يُرسل JSON إلى الخادم فقط لإنشاء الرمز لهذا الطلب، ولا يُخزّن. لا يقرأ المولّد سوى بنية عينتك وأنواع قيمها، لذا يمكنك استبدال القيم الحساسة بعناصر نائبة من النوع نفسه قبل لصقها.

إعلانك هنا؟

[راسلنا عبر البريد الإلكتروني](mailto:hi@dennn.is?subject=%D8%A7%D9%84%D8%A5%D8%B9%D9%84%D8%A7%D9%86%20%D8%B9%D9%84%D9%89%20OneClick%20Pro)

[إعلان 433 أداة لوكلاء الذكاء الاصطناعي عبر خادم MCP واحد.](https://multitaskai.com/ar/?ref=oneclickpro)
