پارشیال کلاس  (partial class)  در سی شارپ

پارشیال کلاس  (partial class)  در سی شارپ

پارشیال کلاس (Partial Class) در سی‌شارپ به شما این امکان را می‌دهد که تعریف یک کلاس را در چندین فایل جداگانه تقسیم کنید.

این ویژگی با استفاده از کلمه کلیدی partial فعال می‌شود و در هنگام کامپایل، تمام این بخش‌ها به یک کلاس واحد ترکیب می‌شوند.

پارشیال کلاس‌ها به‌ویژه در پروژه‌های بزرگ، کار تیمی، و در مواردی که ابزارهای تولید خودکار کد (مانند Windows Forms Designer یا Entity Framework) استفاده می‌شوند، کاربرد دارند.

به‌این‌ترتیب، برنامه‌نویسان می‌توانند کدهای تولیدشده توسط ابزار را از کدهای دستی خود جدا نگه دارند و ساختاری منظم‌تر و قابل مدیریت‌تر ایجاد کنند.

یکی دیگر از قابلیت‌های مرتبط با پارشیال کلاس، پارشیال متد (Partial Method) است.

این متدها می‌توانند در یک فایل تعریف و در فایل دیگری پیاده‌سازی شوند. اگر متد پیاده‌سازی نشود، کامپایلر آن را حذف می‌کند.

این ویژگی به ساده‌تر شدن توسعه و تست پروژه‌ها کمک می‌کند.

بااین‌حال، استفاده از پارشیال کلاس‌ها نیازمند دقت است، چرا که تقسیم بیش‌ازحد کد می‌تواند باعث دشواری در جستجو، اشکال‌زدایی و نگهداری شود.

مثال ساده از پارشیال کلاس

فرض کنید کلاسی دارید که در دو فایل جداگانه تعریف شده است:

File1.cs:

public partial class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
}

File2.cs:

public partial class Person
{
    public void DisplayFullName()
    {
        Console.WriteLine($"{FirstName} {LastName}");
    }
}

هنگام کامپایل، این دو فایل به یک کلاس واحد با نام Person ترکیب می‌شوند. بنابراین شما می‌توانید از کلاس به‌صورت زیر استفاده کنید:

Program.cs:

class Program
{
    static void Main(string[] args)
    {
        Person person = new Person
        {
            FirstName = "Ali",
            LastName = "Ahmadi"
        };
        person.DisplayFullName(); // خروجی: Ali Ahmadi
    }
}

 

🌟 آیا به دنبال یک فرصت عالی برای یادگیری برنامه‌نویسی هستید؟ 🚀

با دوره آموزشی سی‌شارپ ما، شما می‌توانید مهارت‌های خود را به سطح جدیدی ارتقا دهید! این دوره به‌طور کامل طراحی شده تا به شما کمک کند تا از مبتدی تا پیشرفته در دنیای برنامه‌نویسی سی‌شارپ پیش بروید.

👨‍🏫 چرا دوره ما را انتخاب کنید؟

• محتوای جامع و عملی: با پروژه‌های واقعی و تمرینات عملی، یادگیری را به تجربه‌ای جذاب تبدیل کنید.
• مدرس مجرب: از تجربه و دانش مدرس حرفه‌ای بهره‌مند شوید که شما را در هر مرحله از یادگیری راهنمایی می‌کنند.
• پشتیبانی ۲۴/۷: هر زمان که سوالی داشتید، ما در کنار شما خواهیم بود تا به شما کمک کنیم.
• دسترسی مادام‌العمر: به محتوای دوره دسترسی دائمی داشته باشید و هر زمان که خواستید، می‌توانید به آن مراجعه کنید.

💡 فرصت را از دست ندهید!

بایادگیری سی‌شارپ، می‌توانید در دنیای فناوری اطلاعات به یک متخصص تبدیل شوید و در پروژه‌های جذاب و چالش‌برانگیز شرکت کنید.

همین امروز به جمع یادگیرندگان ما بپیوندید و اولین قدم را به سوی آینده‌ای روشن‌تر بردارید!

شرکت در دوره آموزش برنامه نویسی سی شارپ

 

مزایای استفاده از پارشیال کلاس

• تقسیم وظایف در تیم‌های توسعه

  با استفاده از پارشیال کلاس‌ها، اعضای مختلف تیم می‌توانند هم‌زمان روی بخش‌های مختلف یک کلاس کار کنند، بدون اینکه تعارضی در کد به وجود بیاید.

• قابلیت نگهداری و خوانایی بهتر کد

  کلاس‌های بزرگ را می‌توان به بخش‌های کوچکتر و منظم‌تر تقسیم کرد.
  این امر باعث بهبود خوانایی کد و آسان‌تر شدن نگهداری آن می‌شود.

• پشتیبانی از ابزارهای تولید خودکار کد

  بسیاری از ابزارها، مانند Entity Framework و Windows Forms Designer، از پارشیال کلاس‌ها برای جدا کردن کدهای خودکار و کدهای نوشته‌شده توسط برنامه‌نویس استفاده می‌کنند.

• تسهیل تست و دیباگ

  تقسیم یک کلاس به بخش‌های کوچک‌تر می‌تواند فرایند تست و اشکال‌زدایی را ساده‌تر کند.

موارد استفاده رایج از پارشیال کلاس

• تولید کد خودکار توسط ابزارها

  ابزارهایی مانند Visual Studio Designer فایل‌هایی را ایجاد می‌کنند که حاوی کدهای خودکار هستند.
  با استفاده از پارشیال کلاس، این کدها جدا از کدهای اصلی برنامه‌نویس قرار می‌گیرند.

• پروژه‌های بزرگ

  در پروژه‌هایی که کلاسی با تعداد زیادی متد و ویژگی وجود دارد، می‌توان آن را به چندین فایل تقسیم کرد تا مدیریت آن آسان‌تر شود.

• اینترفیس‌های پیچیده

  در برنامه‌هایی که از اینترفیس‌های پیچیده استفاده می‌کنند، تقسیم تعریف کلاس می‌تواند به تفکیک منطق کدنویسی کمک کند.

نحوه استفاده از پارشیال کلاس

برای تعریف یک کلاس به‌صورت پارشیال، کافی است کلمه کلیدی partial را قبل از تعریف کلاس اضافه کنید:

public partial class ClassName
{
    // تعریف بخشی از کلاس
}

این تعریف می‌تواند در چندین فایل جداگانه تکرار شود. فایل‌ها باید در یک فضای نام (namespace) و پروژه یکسان باشند تا در هنگام کامپایل ترکیب شوند.

پارشیال متد (Partial Method)

پارشیال متد یکی دیگر از قابلیت‌های مرتبط با پارشیال کلاس‌ها است.

این متدها در یک فایل تعریف و در فایل دیگر پیاده‌سازی می‌شوند. اگر متد پیاده‌سازی نشود، کامپایلر آن را نادیده می‌گیرد.

File1.cs:

public partial class SampleClass
{
    partial void Log(string message);
    public void Process()
    {
        Log("Processing started...");
    }
}

File2.cs:

public partial class SampleClass
{
    partial void Log(string message)
    {
        Console.WriteLine(message);
    }
}

هنگام اجرای متد Process، پیام Processing started... در خروجی نمایش داده می‌شود. اگر متد Log در هیچ‌کجا پیاده‌سازی نشود، کامپایلر آن را حذف می‌کند.

محدودیت‌های پارشیال متد

• حتماً باید void باشد.

• نمی‌توان آن را public یا protected تعریف کرد.

• باید دارای سطح دسترسی پیش‌فرض (private) باشد.

محدودیت‌های پارشیال کلاس

• وابستگی به فضای نام و پروژه یکسان

  تمام فایل‌های مرتبط با یک کلاس پارشیال باید در یک فضای نام و پروژه تعریف شوند.

• کاهش تمرکز کدنویس

  در برخی موارد، تقسیم یک کلاس به فایل‌های متعدد ممکن است باعث کاهش تمرکز برنامه‌نویس شود.

• مشکلات در جستجو و اشکال‌زدایی

  وقتی یک کلاس به چندین فایل تقسیم می‌شود، یافتن منبع خطا یا یک متد خاص ممکن است دشوار شود.

نکات مهم در استفاده از پارشیال کلاس

• استفاده به‌جا و منطقی

  تقسیم کلاس به چندین فایل نباید باعث پیچیدگی غیرضروری در ساختار پروژه شود.

• هماهنگی تیمی

  در پروژه‌های تیمی، باید از استانداردهای مشخصی برای نام‌گذاری و مکان فایل‌های پارشیال کلاس استفاده شود.

• تعریف فایل‌ها در مسیرهای مناسب

  فایل‌های مرتبط با یک کلاس باید در پوشه‌های مشخص و منطقی قرار بگیرند تا ساختار پروژه سازماندهی‌شده باقی بماند.

مثال پیشرفته از پارشیال کلاس

در مثال زیر، از پارشیال کلاس برای ترکیب کد تولیدشده خودکار و کدهای برنامه‌نویس استفاده می‌کنیم.

Customer.Designer.cs (تولید خودکار):

public partial class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
}

Customer.cs (نوشته‌شده توسط برنامه‌نویس):

public partial class Customer
{
    public void DisplayCustomerInfo()
    {
        Console.WriteLine($"Customer ID: {Id}, Name: {Name}");
    }
}

Program.cs:

class Program
{
    static void Main(string[] args)
    {
        Customer customer = new Customer
        {
            Id = 101,
            Name = "John Doe"
        };
        customer.DisplayCustomerInfo();
    }
}

خروجی:

Customer ID: 101, Name: John Doe

مثال پروژه  محور  از پارشیال کلاس  (partial class)

در اینجا یک مثال پروژه‌محور کوتاه از استفاده پارشیال کلاس ارائه می‌شود.

فرض کنید در حال توسعه یک سیستم مدیریت مشتری هستید که شامل یک کلاس برای نگهداری اطلاعات مشتری است.

بخشی از این کلاس به‌صورت خودکار توسط ابزار تولید شده و بخشی دیگر شامل منطق تجاری است که توسط برنامه‌نویس نوشته می‌شود.

File1: Customer.Designer.cs (تولید خودکار)

public partial class Customer
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
}

File2: Customer.cs (منطق تجاری توسط برنامه‌نویس)

public partial class Customer
{
    public void DisplayCustomerInfo()
    {
        Console.WriteLine($"Customer ID: {Id}, Name: {Name}, Email: {Email}");
    }

    public bool IsEmailValid()
    {
        return Email.Contains("@");
    }
}

File3: Program.cs (اجرای برنامه)

class Program
{
    static void Main(string[] args)
    {
        Customer customer = new Customer
        {
            Id = 1,
            Name = "Ali Ahmadi",
            Email = "ali@example.com"
        };

        customer.DisplayCustomerInfo();
        Console.WriteLine($"Is Email Valid? {customer.IsEmailValid()}");
    }
}

خروجی

Customer ID: 1, Name: Ali Ahmadi, Email: ali@example.com
Is Email Valid? True

توضیح پروژه

در این مثال، فایل اول اطلاعات مشتری را نگهداری می‌کند و فایل دوم شامل منطق تجاری کلاس است. با استفاده از پارشیال کلاس، کد تولید خودکار از کد دستی جدا شده و مدیریت پروژه ساده‌تر می‌شود.