Constructors in CSharp

الـ Constructor هو عبارة عن method خاصة موجودة جوه الـ class، ومسؤولة عن تحط قيم جوا الـ Variables الخاصة بالكلاس دا وبنقول عليها (initializing the variables). بيتم استدعاء وبيحصل Call الـ constructor تلقائيًا أول ما بنعمل instance أو object جديد من الكلاس.

بيتكون من ايه؟

Class Test
{
	// AccessModeifier ClassName(Parameter)
	public Test()
	{
	}
}

• الاسم: اسم الـ constructor لازم يكون هو هو بالظبط اسم الـ class اللي هو موجود فيه. متقدرش تغيره.
• الـ Return Type: الـ constructor مش بيرجع أي قيمة، وعشان كده مينفعش يكون له أي return type، حتى void برضه لأ.
• الـ Access Modifiers: في العادة، بيكون public عشان نقدر نعمل objects من الكلاس في أي مكان. لكن ممكن يكون private أو protected في حالات خاصة زي بعض الـ Design Pattern.
• الاستخدام: بندي قيم ابتدائية للـ fields أو الـ properties بتاع الكلاس.

How Does it Work Without a Defined Constructor?

ممكن تسأل نفسك: إحنا عملنا classes قبل كده ومكتبناش فيها constructor، ومع ذلك كنا بنقدر نعمل object عادي. إزاي ده حصل؟

السبب هو إنه لو المبرمج معرفش أي constructor بنفسه، الـ compiler بيضيف واحد تلقائي وقت الـ compilation. الـ constructor ده بنسميه Implicit Constructor (بَنَّاء ضمني).

graph LR
    subgraph Before Compilation
        A["class Test { int i;}"]
    end

    subgraph After Compilation by Compiler
        B["public Test()    i = 0; // Default initialization"]
    end

    A -->|"Compiler Adds"| B

الـ Implicit Constructor ده بيكون public ومن غير parameters (parameter-less)، ووظيفته إنه يعمل تهيئة لكل متغيرات الكلاس بقيمها الافتراضية (default values).

• الأنواع الرقمية (int, long, float, double): 0
• bool: false
• string, object: null
• char: '\0'

Why Do We Need to Define a Constructor Explicitly?

طالما الـ compiler بيعمل واحد بالنيابة عننا، إيه لزمة إننا نكتب constructor بنفسنا (explicitly)؟

المشكلة في الـ Implicit Constructor (أو حتى الـ Default Constructor اللي بنعمله بقيم ثابتة) هي إنه بيعمل تهيئة لكل الـ objects بنفس القيم.

مثال:

class First
{
    public int x = 100;
}
 
class Test
{
    static void Main(string[] args)
    {
        First f1 = new First();
        First f2 = new First();
        First f3 = new First();
        // All objects will have x = 100
        Console.WriteLine($"{f1.x}, {f2.x}, {f3.x}"); // Output: 100, 100, 100
    }
}

هنا، كل object بنعمله بياخد نفس القيمة 100. لو عايزين ندي لكل object قيمة مختلفة وقت إنشائه، هنا بيجي دور الـ Explicit Parameterized Constructor. ده بيسمحلنا نمرر قيم مختلفة لكل object بنعمله.

class Second
{
    public int x;
    // Explicit Parameterized Constructor
    public Second(int value)
    {
        this.x = value;
    }
}
 
class Test
{
    static void Main(string[] args)
    {
        // Now we can initialize each instance with a different value
        Second s1 = new Second(100); 
        Second s2 = new Second(200);
        Second s3 = new Second(300); 
        Console.WriteLine($"{s1.x}, {s2.x}, {s3.x}"); // Output: 100, 200, 300
    }
}

Types of Constructors

فيه خمس أنواع رئيسية من الـ constructors في لغة C#:

1. Default (Parameter-less) Constructor
2. Parameterized Constructor
3. Copy Constructor
4. Static Constructor
5. Private Constructor

1. Default (Parameter-less) Constructor

ده الـ constructor اللي مش بياخد أي parameters. وهو نوعين:

• الـ System-Defined Default Constructor: ده اللي الـ compiler بيعمله تلقائيًا لو إنت مكتبتش أي constructor خالص. بيكون public وبيعمل تهيئة للمتغيرات بقيمها الافتراضية.
• الـ User-Defined Default Constructor: ده اللي إنت بتكتبه بنفسك بس من غير parameters. بنستخدمه عشان ندي قيم ابتدائية ثابتة لكل الـ objects أو ننفذ logic معين مع كل عملية إنشاء.

مثال User-Defined:

class Employee
{
    public string Name;
    // User-Defined Default Constructor
    public Employee()
    {
        Name = "Default Employee";
    }
}

العيب في النوع ده هو إن كل الـ objects اللي هتعملها هتاخد نفس القيم الثابتة.

2. Parameterized Constructor

ده الـ constructor اللي بياخد parameters. بنستخدمه عشان نمرر قيم مختلفة لكل object بنعمله، وده بيدينا مرونة أكبر.

class Employee
{
    public int Id;
    public string Name;
 
    // User Defined Parameterized Constructor
    public Employee(int id, string name)
    {
        this.Id = id;
        this.Name = name;
    }
}
 
// Usage
Employee emp1 = new Employee(101, "Ahmed");
Employee emp2 = new Employee(102, "Mona");

3. Copy Constructor

ده نوع خاص من الـ Parameterized Constructor بياخد parameter واحد بس، بيكون object من نفس نوع الكلاس. وظيفته إنه ينسخ بيانات object موجود بالفعل في object جديد. ده مفيد لو عايز تعمل نسخة من object معقد من غير ما تعيد تمرير كل قيمه من تاني.

class Employee
{
    public int Id;
    public string Name;
 
    // Parameterized Constructor
    public Employee(int id, string name)
    {
        this.Id = id;
        this.Name = name;
    }
 
    // Copy Constructor
    public Employee(Employee empToCopy)
    {
        this.Id = empToCopy.Id;
        this.Name = empToCopy.Name;
    }
}
 
// Usage
Employee originalEmp = new Employee(101, "Ahmed");
// Create a new employee by copying data from the original
Employee copiedEmp = new Employee(originalEmp); 

4. Static Constructor

ده constructor بنعرفه باستخدام static modifier، وله قواعد وسلوك خاص جدًا.

• مسؤوليته: بيحط قيم في الـ static fields بتاعة الكلاس، أو تنفيذ أي logic محتاج يشتغل مرة واحدة بس على مستوى الكلاس كله.
• الاستدعاء: بيتنادى بشكل ضمني (implicitly) مرة واحدة بس في دورة حياة التطبيق (يعني لما نشغل الابلكيشن ويقفل فالاخر هي دي دورة الحياة).
• توقيت التنفيذ: بيتنفذ تلقائيًا قبل ما تعمل أول object من الكلاس، أو قبل ما توصل لأي member static (متغير أو method) في الكلاس ده لأول مرة. هو أول حاجة بتتنفذ في الكلاس.
• قواعده:
  • مينفعش ياخد أي access modifiers (لا public ولا private).
  • لازم يكون من غير parameters.
  • مينفعش نستدعيه بنفسنا بشكل صريح.
  • مينفعش نعمله overloading، وممكن يكون فيه واحد بس في الكلاس.
  • بيقدر يوصل للـ static members بس.

public class DatabaseConnection
{
    // Static Constructor
    static DatabaseConnection()
    {
        Console.WriteLine("Static Constructor Executed: Initializing database connection settings...");
    }
 
    // Instance Constructor
    public DatabaseConnection()
    {
        Console.WriteLine("Instance Constructor Executed.");
    }
}
 
class Program
{
    static void Main(string[] args)
    {
        Console.WriteLine("Main method started.");
        // Static constructor runs here, before the first instance is created
        DatabaseConnection conn1 = new DatabaseConnection();
        DatabaseConnection conn2 = new DatabaseConnection();
        Console.WriteLine("Main method finished.");
    }
}

Output:

Main method started.
Static Constructor Executed: Initializing database connection settings...
Instance Constructor Executed.
Instance Constructor Executed.
Main method finished.

5. Private Constructor

ده constructor بنعرفه باستخدام private access modifier.

• تأثيره الأساسي: بيمنع اننا نعمل object من الكلاس ده من بره الكلاس. لكن نقدر نعمل objects جوه نفس الكلاس عادي.
• الوراثة: مش بيمنع الوراثة بشكل مطلق. لو فيه public constructor تاني، ممكن تورث الكلاس. لكن لو كل الـ constructors اللي فيه private، ساعتها مش هتقدر تورثه من كلاس خارجي. لو عايز تمنع الوراثة تمامًا، استخدم sealed class.
• الاستخدام الأشهر: تطبيق الـ Singleton Design Pattern، وهو نمط بيضمن إنك تعمل object واحد بس من الكلاس ده على مستوى التطبيق كله.

public sealed class Singleton
{
    private static Singleton _instance = null;
    private static int counter = 0;
 
    // The private constructor prevents creating instances from outside
    private Singleton()
    {
        counter++;
        Console.WriteLine($"Singleton instance created. Counter: {counter}");
    }
 
    public static Singleton GetInstance()
    {
        if (_instance == null)
        {
            _instance = new Singleton();
        }
        return _instance;
    }
}

Advanced Concepts

Constructor Overloading

الـ Overloading معناه إنك يكون عندك أكتر من constructor في نفس الكلاس، كل واحد له signature مختلفة (يعني عدد أو نوع أو ترتيب الـ parameters مختلف).

ودا نوع من انواع الـ Method Overloading اللي هو عبارة عن Compile-time Polymorphism

public class Car 
{
	// Overloaded constructors
	public Car () { Console.WriteLine("Default car created."); }
	public Car (string model) { Console.WriteLine($"{model} created."); }
	public Car (string model, int year) { Console.WriteLine($"{model} from {year} created."); }
}

Constructor Chaining

أحيانًا بيكون عندك كود مكرر في أكتر من constructor. عشان تتجنب التكرار ده وتخلي كودك أنضف، ممكن تستخدم Constructor Chaining، وده معناه إن constructor ينادي على constructor تاني في نفس الكلاس. بنعمل ده باستخدام كلمة this.

public class Customer
{
    public List<Order> Orders;
    public int ID;
    public string Name;
 
    // 1. Default constructor initializes the list
    public Customer()
    {
        Orders = new List<Order>();
    }
    
    // 2. This constructor calls the default one first using ': this()'
    public Customer(int id)
        : this() 
    {
        this.ID = id;
    }
 
    // 3. This constructor calls the one with the 'id' parameter first
    public Customer(int id, string name)
        : this(id)
    {
        // By the time this code runs, the list is initialized and the ID is set.
        this.Name = name;
    }
}

ملحوظة: الـ constructor اللي بنعمله chain بيتنفذ الأول، وبعدين الكود اللي جوه الـ constructor الحالي بيتنفذ.

Important Distinctions

Struct vs. Class Constructors

• الـ Class: الـ default constructor (الضمني) بيتعمل بس لو أنت معملتش أي constructor بنفسك. لو عملت واحد، الافتراضي بيتلغي.
• الـ Struct: الـ default constructor بيتعمل دايمًا ومتقدرش تمنعه أو تغيره. لو عملت constructor بـ parameters، لازم تعمل initialize لكل الـ fields اللي جوه الـ struct.

Static vs. Non-Static Constructors

الميزة	Static Constructor	Non-Static (Instance) Constructor
التعريف	بيستخدم static modifier	مش بيستخدم static modifier
المسؤولية	بنحط قيم في الـ static data	بنحط قيم في الـ non-static (instance) data
الاستدعاء	ضمني (Implicit)	صريح (Explicit)
عدد مرات التنفيذ	مرة واحدة بس	صفر أو أكتر (مع كل instance جديد)
الـ Parameters	مينفعش ياخد parameters	ممكن ياخد parameters
الـ Overloading	مينفعش نعمله overloading	ممكن نعمله overloading
الـ Access Modifier	مينفعش ياخد أي access modifier	ممكن ياخد أي access modifier (public, private, etc.)