Comment

Comment ဆိုတာ Code ရဲ့ ရည်ရွယ်ချက်နဲ့ အလုပ်လုပ်ပုံကို ရှင်းပြဖို့ ရေးထားတဲ့ မှတ်ချက်ဖြစ်ပါတယ်။

Comment ကို Compiler က Program ရဲ့ လုပ်ဆောင်ချက်အဖြစ် မသတ်မှတ်တဲ့အတွက် Output မှာ ပေါ်လာမှာမဟုတ်ပါဘူး။

Comment တွေကို—

Code ရဲ့ ရည်ရွယ်ချက်ရှင်းပြဖို့
နားလည်ရခက်တဲ့ Logic ကို မှတ်ချက်ရေးဖို့
နောင်တစ်ချိန် Code ပြန်ဖတ်တဲ့အခါ နားလည်လွယ်စေဖို့
အခြား Developer တွေ Code ကို နားလည်စေဖို့

အသုံးပြုပါတယ်။

1. Single-line Comment

စာကြောင်းတစ်ကြောင်းတည်း Comment ရေးချင်ရင် // ကို အသုံးပြုပါတယ်။

// အသုံးပြုသူကို အမည်ထည့်ခိုင်းခြင်း
Console.Write("Enter your name: ");

// အသုံးပြုသူထည့်သော အမည်ကို လက်ခံခြင်း
string? name = Console.ReadLine();

// Greeting Message ပြသခြင်း
Console.WriteLine($"Hello, {name}!");

// ရဲ့နောက်မှာ ရေးထားတဲ့ စာသားကို Program က အလုပ်မလုပ်ပါဘူး။

2. Multi-line Comment

စာကြောင်းအများကြီးပါတဲ့ Comment ရေးချင်ရင် /* နဲ့ */ ကြားမှာ ရေးနိုင်ပါတယ်။

/*
ဒီ Program က အသုံးပြုသူဆီက
အမည်နဲ့ သင်တန်းအမည်ကို လက်ခံပြီး
Student Information ပြန်လည်ပြသပေးပါတယ်။
*/

Console.Write("Enter your name: ");
string? name = Console.ReadLine();

Console.Write("Enter your course: ");
string? course = Console.ReadLine();

Console.WriteLine($"Name: {name}");
Console.WriteLine($"Course: {course}");

3. XML Documentation Comment

Class သို့မဟုတ် Method တွေရဲ့ အသုံးပြုပုံကို Documentation ရေးချင်ရင် /// ကို အသုံးပြုနိုင်ပါတယ်။

/// <summary>
/// Student အမည်ကို Console ပေါ်တွင် ပြသပေးသည်။
/// </summary>
static void ShowStudentName()
{
Console.WriteLine("Aung Aung");
}

Beginner အဆင့်မှာ // နဲ့ /* */ ကို နားလည်အသုံးပြုနိုင်ရင် လုံလောက်ပါတယ်။ XML Documentation Comment ကို Methods နဲ့ OOP အပိုင်းတွေမှာ ပိုမိုအသုံးပြုလာပါမယ်။

4. Comment ရေးတဲ့အခါ သတိပြုရန်

Comment တွေက Code ကို နားလည်လွယ်စေပေမယ့် Code တစ်ကြောင်းတိုင်းကို Comment ရေးဖို့ မလိုအပ်ပါဘူး။

မလိုအပ်တဲ့ Comment နမူနာ—

// Hello ကို ပြမယ်
Console.WriteLine("Hello");

အဓိပ္ပာယ်ရှိတဲ့ Comment နမူနာ—

// User Registration အတွက် အသုံးပြုသူ၏ အခြေခံအချက်အလက်များ လက်ခံခြင်း
Console.Write("Enter your name: ");
string? name = Console.ReadLine();

ကောင်းမွန်တဲ့ Variable Name နဲ့ ရှင်းလင်းတဲ့ Code ရေးသားခြင်းကို ဦးစားပေးပြီး လိုအပ်တဲ့နေရာမှာသာ Comment ထည့်သင့်ပါတယ်။


လက်တွေ့လေ့ကျင့်ခန်း (1)
အသုံးပြုသူဆီက အောက်ပါအချက်အလက်များ လက်ခံပြီး ပြန်လည်ပြသတဲ့ Program တစ်ခု ရေးပါ။

အမည်
Email
ဖုန်းနံပါတ်
မြို့
လေ့လာလိုတဲ့ Course

Output နမူနာ—

===== User Profile =====
Name: Aung Aung
Email: aung@example.com
Phone: 09123456789
City: Mandalay
Course: C# Programming Basic
========================

လက်တွေ့လေ့ကျင့်ခန်း (2)

ပစ္စည်းတစ်ခုရဲ့ အမည်၊ ဈေးနှုန်းနဲ့ အရေအတွက်ကို အသုံးပြုသူဆီက လက်ခံပြီး ပြန်လည်ပြသပါ။

===== Product Information =====
Product: Keyboard
Price: 45000
Quantity: 2
===============================

ဒီအဆင့်မှာ Total Amount တွက်ချက်စရာ မလိုသေးပါဘူး။ Input လက်ခံခြင်းနဲ့ Output ပြန်လည်ပြသခြင်းကို အဓိက လေ့ကျင့်ပါ။

လက်တွေ့လေ့ကျင့်ခန်း (3)

အောက်ပါ Code ကို ကြည့်ပြီး ထွက်လာမယ့် Output ကို ခန့်မှန်းပါ။

Console.Write("C# ");
Console.WriteLine("Programming");
Console.Write("Lesson ");
Console.WriteLine(4);

အဖြေ—