المستوى: مبتدئ · وقت التعلم المتوقع: 8 دقيقة
باختصار: التعليق ملاحظة للمبرمج لا تُنفّذ باعتبارها أمرًا. في C#، ستستخدم المثال التالي ثم تنفذ تمرينًا بسيطًا بنفسك.
ماذا ستتعلم؟
- كتابة ملاحظة تشرح هدف السطر
- تشغيل مثال قصير وقراءة النتيجة
- إجراء تغيير بسيط بنفسك
قبل أن تبدأ
أنشئ مشروع Console باستخدام .NET ثم ضع كود المثال في Program.cs.
المقدمة
في هذا الدرس من سلسلة C# للمبتدئين سنتعلم التعليقات، دون افتراض خبرة برمجية سابقة. التعليق ملاحظة للمبرمج لا تُنفّذ باعتبارها أمرًا.
الشرح خطوة بخطوة
راقب رمز التعليق في المثال: النص بعده يشرح السطر التالي دون أن يغيّر الناتج.
في اللغات التي تحتاج إلى مترجم، انسخ المثال كاملًا لأن الأسطر التي تجهز البرنامج جزء من طريقة تشغيله. اقرأ الأوامر من الأعلى إلى الأسفل، ثم غيّر قيمة واحدة فقط في كل تجربة حتى تفهم أثرها.
مثال عملي قابل للتجربة
using System;
class Program {
static void Main() {
// هذه رسالة ترحيب
Console.WriteLine("مرحبًا");
}
}ماذا تتوقع أن يحدث؟
التعليق الجيد يشرح السبب ولا يكرر ما يفعله الكود حرفيًا.
تمرين للتطبيق
اكتب تعليقًا يشرح لماذا يظهر البرنامج كلمة مرحبًا.
جرّب وحدك أولًا. إذا ظهرت رسالة خطأ، قارن الكود بالنسخة الأصلية حرفًا حرفًا ثم أعد التشغيل.
تحقق من فهمك
سؤال: ماذا سيحدث إذا نفذت التغيير المذكور في التمرين؟ اكتب توقعك أولًا، ثم شغّل المثال وقارن النتيجة.
خلاصة الدرس
تعلمت اليوم التعليقات في C#، وطبقت مثالًا صغيرًا يساعدك على بناء الخطوة التالية.
المرجع الرسمي
مرجع C# الرسمي أو التقني للاطلاع الاختياري؛ لا تحتاج إلى قراءته كاملًا الآن.
الدرس التالي: 04 | المتغيرات في C# للمبتدئين
