""" """
النصوص الحرفية الخام (Raw String Literals) """ """
منذ C# 11، تسمح علامات الاقتباس الثلاثية بكتابة نص متعدّد الأسطر يحتوي علامات اقتباس أو شرطات مائلة عكسية دون أي رمز تهريب escape.
النص المحاط بثلاث علامات اقتباس مزدوجة (أو أكثر) يُقرأ حرفيًا كما هو مكتوب — مفيد جدًا لكتابة JSON أو مسارات ملفات Windows أو تعبيرات نمطية دون تكرار \\ أو \". إن احتاج النص نفسه لتضمين ثلاث علامات اقتباس متتالية، تبدأ وتنهي النص الخام بعدد أكبر من علامات الاقتباس.
عند وضع علامات البداية والنهاية على أسطر منفصلة، يحدّد عمود علامة النهاية أقصى يسار للنص، فيمكن تنسيق النص الخام ليطابق مسافة الإزاحة indentation المحيطة به دون أن تصبح تلك المسافة جزءًا من القيمة الفعلية.
الصياغة
var text = """ محتوى النص هنا بأي علامات اقتباس " داخلها """;
📄 مثال
var json = """
{
"name": "براء"
}
""";أهم النقاط
| العنصر | الوظيفة |
|---|---|
| """ ... """ | حدّ أدنى ثلاث علامات اقتباس مزدوجة لبداية ونهاية النص الخام |
| بلا escape | لا حاجة لـ \" أو \\ داخل النص |
| متوفّرة منذ | C# 11 |
💡 نصائح عملية
- استخدمها لكتابة JSON أو SQL أو تعبيرات نمطية مباشرة داخل الكود دون تشويه بعلامات التهريب
⚠️ أخطاء شائعة
- نسيان أن عمود علامة الاقتباس الختامية يحدّد أقصى يسار للنص — إزاحة غير متّسقة تُدرَج كجزء من القيمة
🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار CSHARP الكامل بالعربي.