0Pricing
C# Academy · درس

حرفيات السلاسل النصية الخام

اكتبوا نصوصًا متعددة الأسطر وكثيرة علامات الاقتباس بوضوح

حرفيات السلاسل النصية الخام درس مجاني في C# Academy على CoddyKit. هذا هو الدرس 4 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في C# Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة C# Academy 4 دروس في المجموع.

القيم الحرفية للسلاسل النصية الخام

تُحاط القيمة الحرفية للسلسلة النصية الخام بثلاث علامات اقتباس مزدوجة على الأقل. وتُؤخذ الأحرف داخلها حرفيًا دون معالجة لمحارف الهروب.

using System;

class Program {
    static void Main() {
        string s = """Hello "World"!""";
        Console.WriteLine(s);
    }
}

عدم استخدام متتاليات الهروب

تُعامل الشرطات المائلة العكسية كشرطات عادية داخل السلسلة النصية الخام، ما يجعلها مثالية لمسارات الملفات وأنماط regex.

using System;

class Program {
    static void Main() {
        string path = """C:\Users\Ada\file.txt""";
        Console.WriteLine(path);
    }
}

تضمين علامات الاقتباس

لأن المحدِّد يتكون من ثلاث علامات اقتباس أو أكثر، فلا تحتاج علامات الاقتباس المفردة والمزدوجة داخل السلسلة إلى تهريب.

using System;

class Program {
    static void Main() {
        string json = """{"name": "Ada", "age": 30}""";
        Console.WriteLine(json);
    }
}

السلاسل النصية الخام متعددة الأسطر

للمحتوى متعدد الأسطر، ضع علامتي الاقتباس الافتتاحية والختامية في سطرين مستقلين. ويُحافَظ على النص الواقع بينهما.

using System;

class Program {
    static void Main() {
        string text = """
        Line one
        Line two
        """;
        Console.WriteLine(text);
    }
}

إزالة المسافة البادئة

في السلاسل النصية الخام متعددة الأسطر، تحدد المسافات البيضاء قبل علامات الاقتباس الختامية مستوى المسافة البادئة الأساسي، ثم تُزال من كل سطر.

using System;

class Program {
    static void Main() {
        string s = """
            indented in source
            but flush in output
            """;
        Console.WriteLine(s);
    }
}

المزيد من علامات الاقتباس لتجنب التعارض

إذا احتوى المحتوى على ثلاث علامات اقتباس، فاستخدم أربع علامات أو أكثر في المحدِّد حتى تكون السلسلة غير ملتبسة.

using System;

class Program {
    static void Main() {
        string s = """"He said """quote""" today."""";
        Console.WriteLine(s);
    }
}

الاستيفاء الخام

أضف علامة الدولار في البداية للسلاسل النصية الخام المستوفاة. ويحدد عدد علامات الدولار عدد الأقواس المعقوفة التي تبدأ تعبيرًا.

using System;

class Program {
    static void Main() {
        string name = "Ada";
        string s = $"""Hello, {name}!""";
        Console.WriteLine(s);
    }
}

علامتا دولار للأقواس المعقوفة الحرفية

مع استخدام علامتي دولار، تكون الأقواس المعقوفة المفردة حرفية، بينما تبدأ الأقواس المزدوجة تعبيرًا؛ وهذا مفيد لقوالب JSON.

using System;

class Program {
    static void Main() {
        string id = "42";
        string s = $$"""{ "id": {{id}} }""";
        Console.WriteLine(s);
    }
}

أوضح من الصيغة الحرفية

تحل السلاسل النصية الخام محل كثير من استخدامات الصيغة الحرفية الأقدم، مع معالجة أوضح لعلامات الاقتباس والمسافات البادئة.

using System;

class Program {
    static void Main() {
        string sql = """
        SELECT *
        FROM Users
        WHERE Active = 1
        """;
        Console.WriteLine(sql);
    }
}

ممتازة للقوالب

تجعل السلاسل النصية الخام تضمين JSON أو XML أو HTML أو SQL أمرًا مقروءًا، إذ لا يحتاج أي شيء داخلها إلى تهريب.

using System;

class Program {
    static void Main() {
        string html = """<a href="/home">Home</a>""";
        Console.WriteLine(html);
    }
}

متى تُستخدم

استخدم السلاسل النصية الخام كلما احتوى النص على كثير من علامات الاقتباس أو الشرطات المائلة العكسية أو امتد عبر عدة أسطر.

using System;

class Program {
    static void Main() {
        string regex = """\d{3}-\d{4}""";
        Console.WriteLine(regex);
    }
}

تحقق سريع

اختبر مدى فهمك للقيم الحرفية للسلاسل النصية الخام.

مراجعة

تستخدم القيم الحرفية للسلاسل النصية الخام ثلاث علامات اقتباس مزدوجة أو أكثر، وتأخذ محتواها حرفيًا دون متتاليات هروب، مما يجعلها مثالية للمسارات وregex وJSON وHTML. وتحافظ الإصدارات متعددة الأسطر على التخطيط وتزيل المسافة البادئة قبل علامات الاقتباس الختامية.

أضف مزيدًا من علامات الاقتباس عند حدوث تعارض مع المحتوى، وأضف علامات الدولار في البداية للاستيفاء، حيث تغير علامات الدولار الإضافية طريقة تفسير الأقواس المعقوفة.

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

هل درس «حرفيات السلاسل النصية الخام» مجاني؟

نعم — نص درس «حرفيات السلاسل النصية الخام» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة C# Academy، انتقل إلى CoddyKit PRO. تتضمن دورة C# Academy 4 دروس في المجموع.

ماذا ستتعلم في «حرفيات السلاسل النصية الخام»؟

اكتبوا نصوصًا متعددة الأسطر وكثيرة علامات الاقتباس بوضوح تتمرن على C# Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ C# Academy؟

لا تُشترط خبرة سابقة. C# Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 4 من أصل 4.

كم من الوقت يستغرق درس «حرفيات السلاسل النصية الخام»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس C# Academy هذا؟

نعم. كل درس في C# Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

  1. أساسيات استيفاء السلاسل النصية
  2. التنسيق المركّب باستخدام string.Format
  3. محدّدات تنسيق الأرقام والتواريخ
  4. حرفيات السلاسل النصية الخام
← العودة إلى C# Academy