اثر پروانه ای

delegate void MyDel(int value); // Declare delegate TYPE.
class Program
{
    void PrintLow(int value)
    {
        Console.WriteLine("{0} - Low Value", value);
    }
    void PrintHigh(int value)
    {
        Console.WriteLine("{0} - High Value", value);
    }
    static void Main()
    {
        Program program = new Program();
        MyDel del; // Declare delegate variable.
        // Create random-integer-generator object and get a random
        // number between 0 and 99.
        Random rand = new Random();
        int randomValue = rand.Next(99);
        // Create a delegate object that contains either PrintLow or
        // PrintHigh, and assign the object to the del variable.
        del = randomValue < 50
        ? new MyDel(program.PrintLow)
        : new MyDel(program.PrintHigh);
        del(randomValue); // Execute the delegate.
    }
}

چون ما از عدد شانسی استفاده می کنیم، نتیجه اجرای برنامه هربار تغییر می کند. در یکی از اجراها نتیجه زیر حاصل شد:

28 - Low Value

بررسی اجمالی delegate ها

حالا اجازه بدین کمی به جزئیات بپردازیم. یک delegate یک نوع-کاربرتعریف است، درست همونطوری که یک کلاس می تونه کاربرتعریف باشه (یعنی خود برنامه نویس اونو تعریف می کنه). اما درحالیکه یک کلاس نشاندهنده مجموعه از داده ها و متدهاست ، یک delegate از یک یا بیش از یک متد و مجموعه ای از اعمال از پیش تعریف شده نگهداری می کند.

شما با انجام مراحل زیر از یک delegate استفاده می کنید. من در قسمت های آینده هر یک از مراحل زیر رو با جزئیات توضیح خواهم داد.

1. یک نوع وکالتی (delegate) را اعلان کنید. اعلان delegate مشابه اعلان متد است، با این تفاوت که وکیل دارای بلوک پیاده سازی نمی باشد.
2. یک متغیر وکالتی از نوع همان وکیلی که ساخته بودید اعلان کنید.
3. یک شیئ از نوع همان وکیل ساخته و متغیر وکالتی را به آن انتساب دهید. شیئ وکالتی جدید حاوی یک ارجاع به یک متد است که آن متد باید دارای امضا و نوع برگشتی مشابه نوع وکالتی تعریف شده در گام اول باشد.
4. شما می توانید بطور اختیاری متدهای اضافی را به شیئ وکالتی اضافه کنید. این متد های باید حتما" دارای امضا و نوع برگشتی مشابه نوع وکالتی تعریف شده در گام اول باشند.
5. در داخل کدنویسی خودتان می توانید وکیل را احضار کنید، درست همانطوری که یک متد را احضار می کنید. وقتی delegate را احضار می کنید، تک تک متدهایی که در داخل delegate وجود دارد اجرا می شوند.

با نگاه کردن به گام های قبل، متوجه خواهید شد که این مراحل شبیه مراحل ساختن کلاس هستند. شکل زیر مراحل ساختن و استفاده کردن کلاس ها و delegate ها را با هم مقایسه می کند.

شما می توانید یک delegate را بصورت یک شیئ که حاوی یک لیست مرتب شده از متدهاست تصور کنید. متدها دارای امضا و نوع برگشتی مشابه وکیل خود می باشند.

• به لیست متدها "لیست احضار (Invocation list)" می گویند.
• متدهای نگهداری شده توسط یک وکیل می توانند متعلق به هر کلاس یا ساختاری باشند، تا زمانی که با دو مورد زیر مطابقت داشته باشند:
  • نوع برگشتی وکیل
  • امضای وکیل (شامل اصلاحگرهای ref و out)

• متدهای موجود در لیست احضار می توانند متدهای نمونه یا متدهای استاتیک باشند.
• وقتی یک delegate احضار شود، تک تک متدهای موجود در لیست احضارش اجرا می شوند.