Command-Line Arguments in CSharp

في المقال ده، هنشرح الـ Command Line Arguments في لغة C# وهنشوف أمثلة عملية عليها.

Understanding Command-Line Arguments

إحنا عارفين إننا ممكن نمرر parameters لأي function كـ argument، بس هل ممكن نعمل نفس الكلام مع الـ Main(string[] args) method؟

الإجابة هي أيوة، ممكن. وده بيتم عن طريق اللي بنسميه Command-Line Arguments. ببساطة، دي الـ arguments اللي اليوزر أو المبرمج بيمررها للـ Main() method وقت تشغيل البرنامج.

الـ Main() method هي نقطة البداية اللي بيبدأ من عندها تنفيذ أي برنامج. نقطة مهمة لازم تاخد بالك منها هي إن الـ Main() method مش بتقبل أي parameters من أي method تانية جوه الكود، هي بتقبل parameters من الـ Command-Line بس.

لو بصيت على الـ signature بتاع الـ Main() method، هتلاقي إنها بتاخد parameter من نوع string array اسمه args. الـ array ده يقدر يستقبل أي عدد من الـ arguments وقت تشغيل البرنامج (runtime).

Passing Arguments via Visual Studio

خلينا نعمل console application جديد ونعدّل ملف Program.cs بالكود ده:

Code Example: Accessing String Arguments

using System;
 
namespace FirstProgram
{
    class Program
    {
        static void Main(string[] args)
        {
            // Print the first argument
            Console.WriteLine($"First Command Line Argument {args[0]}");
            
            // Print the second argument
            Console.WriteLine($"Second Command Line Argument {args[1]}");
            
            // Print the third argument
            Console.WriteLine($"Third Command Line Argument {args[2]}");
            
            Console.ReadLine();
        }
    }
}

الكود اللي فوق ده متوقع إننا نمرر له على الأقل 3 parameters للـ Main() method.

Potential Errors: IndexOutOfRangeException

لو شغّلت البرنامج دلوقتي، هيحصل runtime exception من نوع System.IndexOutOfRangeException ورسالته هتكون: ‘Index was outside the bounds of the array’.

وده منطقي جدًا، لإننا مشغلناش البرنامج ومعاه أي arguments، وبالتالي الـ string array اللي اسمه args فاضي ومفيهوش أي عناصر، وإحنا بنحاول نوصل لعناصر مش موجودة فيه أساسًا.

السؤال دلوقتي، إزاي نمرر arguments للـ Main() method؟ الإجابة هي عن طريق الـ Command-Line.

How to Set Arguments in Visual Studio

عشان نمرر الـ arguments من خلال Visual Studio، اتبع الخطوات دي:

graph TD
    A[Right-click on the project in Solution Explorer] --> B[Click on Properties];
    B --> C[Select the Debug tab];
    C --> D[Enter values in the 'Command line arguments' textbox];

1. افتح الـ Properties window. عشان تفتحها، دوس كليك يمين على الـ project بتاعك في الـ Solution Explorer واختار Properties.

2. من شاشة الـ Properties، اختار الـ Debug tab.

3. في الـ Command line arguments textbox، اكتب القيم اللي عايز تمررها للـ Main() method، وخلي بينهم مسافة. في مثالنا، إحنا محتاجين 3 قيم، فهنكتب مثلًا: Value1 Value2 Value3.

Output

هنا، Value1 هتتخزن في args[0]، وValue2 هتتخزن في args[1]، وValue3 هتتخزن في args[2].

دلوقتي اعمل Save وشغّل البرنامج، هتلاقي النتيجة دي ظهرت في الـ Console:

First Command Line Argument Value1
Second Command Line Argument Value2
Third Command Line Argument Value3

Important Points

• الـ Command Line Arguments بتستقبلها في string array، اللي هو الـ parameter اللي اسمه args في الـ Main() method.
• بشكل عام، الـ Command Line Arguments بتُستخدم عشان تحدد معلومات خاصة بالـ configuration وقت تشغيل البرنامج.
• المعلومات دي دايمًا بتتبعت على هيئة string.
• مفيش أي قيود على عدد الـ arguments، ممكن تمرر صفر أو أي عدد (n) من الـ arguments.

Handling Numeric Arguments

في C#، الـ Command Line Arguments دايمًا بتتخزن كـ string وبتكون مفصولة بمسافات. الـ Main() method مش بتقبل غير string arguments.

طيب لو البرنامج محتاج يتعامل مع numeric command-line argument؟ اللي عليك تعمله إنك تمرر الرقم كـ string عادي، وجوه البرنامج بتاعك، مسئوليتك إنك تحوّل الـ string ده لقيمة رقمية. بكده، بنقدر نتعامل مع أرقام عن طريق الـ command line.

Code Example: Converting to Numeric Types

using System;
 
namespace FirstProgram
{
    class Program
    {
        static void Main(string[] args)
        {
            // Convert the first argument to an integer
            int argument1 = Convert.ToInt32(args[0]);
            Console.WriteLine("Argument in Integer Form : " + argument1);
 
            // Convert the second argument to a double
            double argument2 = Convert.ToDouble(args[1]);
            Console.WriteLine("Argument in Double Form : " + argument2);
            
            Console.ReadLine();
        }
    }
}

دلوقتي، عدّل القيم في شاشة Properties → Debug وخليها أرقام، زي كده: 100 250.75

اعمل Save وشغّل البرنامج، والنتيجة هتكون:

Argument in Integer Form : 100
Argument in Double Form : 250.75

Potential Errors: FormatException

طب إيه اللي هيحصل لو الـ argument اللي اتبعت مينفعش يتحول للنوع الرقمي المطلوب؟

لو الـ argument مقدرش يتحول، هيحصل runtime error من نوع System.FormatException ورسالته هتكون: ‘Input string was not in a correct format.’

خلينا نغير الـ command line arguments ونخليها بالشكل ده: 100 Hello. هنا الـ argument التاني نوعه string ومينفعش يتحول لـ double.

لو عملت Save وشغّلت البرنامج، هيظهرلك الـ runtime error ده.