Click here to Skip to main content
15,867,756 members
Articles / Desktop Programming / Windows Forms
Article

Understanding Delegates in C#

Rate me:
Please Sign up or sign in to vote.
4.34/5 (174 votes)
15 Sep 2005CPOL2 min read 831.8K   124   85
This article describes delegates in C#.

Introduction

Delegate is like a buzz word in C#.NET programming. In this article, I explain delegates, multicast delegates and their usage with the help of simple C# programs.

What is a Delegate?

Delegate is a type which  holds the method(s) reference in an object. It is also referred to as a type safe function pointer.

Advantages

  • Encapsulating the method's call from caller
  • Effective use of delegate improves the performance of application
  • Used to call a method asynchronously

Declaration

public delegate type_of_delegate delegate_name()

Example:

C#
public delegate int mydelegate(int delvar1,int delvar2)

Note

  • You can use delegates without parameters or with parameter list
  • You should follow the same syntax as in the method
    (If you are referring to the method with two int parameters and int return type, the delegate which you are declaring should be in the same format. This is why it is referred to as type safe function pointer.)

Sample Program using Delegate

C#
public delegate double Delegate_Prod(int a,int b);
class Class1
{
    static double fn_Prodvalues(int val1,int val2)
    {
        return val1*val2;
    }
    static void Main(string[] args)
    {
        //Creating the Delegate Instance
        Delegate_Prod delObj = new Delegate_Prod(fn_Prodvalues);
        Console.Write("Please Enter Values");
        int v1 = Int32.Parse(Console.ReadLine());
        int v2 = Int32.Parse(Console.ReadLine());
        //use a delegate for processing
        double res = delObj(v1,v2);
        Console.WriteLine ("Result :"+res);
        Console.ReadLine();
    }
}

Explanation

Here I have used a small program which demonstrates the use of delegate.

The delegate "Delegate_Prod" is declared with double return type and accepts only two integer parameters.

Inside the class, the method named fn_Prodvalues is defined with double return type and two integer parameters. (The delegate and method have the same signature and parameter type.)

Inside the Main method, the delegate instance is created and the function name is passed to the delegate instance as follows:

C#
Delegate_Prod delObj = new Delegate_Prod(fn_Prodvalues);

After this, we are accepting the two values from the user and passing those values to the delegate as we do using method:

C#
delObj(v1,v2);

Here delegate object encapsulates the method functionalities and returns the result as we specified in the method.

Multicast Delegate

What is Multicast Delegate?

It is a delegate which holds the reference of more than one method.

Multicast delegates must contain only methods that return void, else there is a run-time exception.

Simple Program using Multicast Delegate

C#
delegate void Delegate_Multicast(int x, int y);
Class Class2
{
    static void Method1(int x, int y)
    {
        Console.WriteLine("You r in Method 1");
    }

    static void Method2(int x, int y)
    {
        Console.WriteLine("You r in Method 2");
    }

    public static void <place w:st="on" />Main</place />()
    {
        Delegate_Multicast func = new Delegate_Multicast(Method1);
        func += new Delegate_Multicast(Method2);
        func(1,2);             // Method1 and Method2 are called
        func -= new Delegate_Multicast(Method1);
        func(2,3);             // Only Method2 is called
    }
}

Explanation

In the above example, you can see that two methods are defined named method1 and method2 which take two integer parameters and return type as void.

In the main method, the Delegate object is created using the following statement:

C#
Delegate_Multicast func = new Delegate_Multicast(Method1);

Then the Delegate is added using the += operator and removed using the -= operator.

Conclusion

This article would help to understand delegates in C# using simple examples. If you have any query regarding this article, you can reach me at arul_tony@yahoo.com.

History

  • 16th September, 2005: Initial post

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Web Developer
India India
Working as a Software Engineer in a MNC Company.Knowledge on C#.NET, ASP.NET, VB.NET ,VB & SQL Server.

Comments and Discussions

 
GeneralMulticast delegate Pin
Niraj_Kheria16-Sep-07 22:02
Niraj_Kheria16-Sep-07 22:02 
GeneralMulticast delegate [modified] Pin
Arijit Pal16-Sep-07 21:54
Arijit Pal16-Sep-07 21:54 
GeneralV.I Question In Delegate [modified] Pin
msleem14-May-07 7:00
msleem14-May-07 7:00 
GeneralRe: V.I Question In Delegate Pin
Vikas_Awasthi13-Jan-11 10:01
Vikas_Awasthi13-Jan-11 10:01 
Generallack of fanciness Pin
azam's12-Feb-07 23:45
azam's12-Feb-07 23:45 
GeneralSimply Great!! Pin
irula5-Jan-07 1:30
irula5-Jan-07 1:30 
GeneralMulticast Delegates may also call methods returning values without error Pin
ambujsaxena13-Nov-06 0:37
ambujsaxena13-Nov-06 0:37 
GeneralRe: Multicast Delegates may also call methods returning values without error Pin
PavanPT3-Apr-07 22:27
PavanPT3-Apr-07 22:27 
Hi,

I have tryed creating more than 2 methods and associating it with this delegate. I have got no error for that matter my methods were firing messages in the same order i associated to the delegate. That a great information to a starter like me. If possible plz send the actual methods you have creted and the way you are invoking as we can try to debug and fix it.

Kind regs,
Pavan
GeneralRe: Multicast Delegates may also call methods returning values without error Pin
samir411802-Oct-07 7:04
samir411802-Oct-07 7:04 
GeneralErrata Pin
mohitcalling11-Oct-06 21:45
mohitcalling11-Oct-06 21:45 
GeneralRe: Errata Pin
azam's12-Feb-07 23:21
azam's12-Feb-07 23:21 
GeneralRe: Errata Pin
mohitcalling18-Nov-08 21:07
mohitcalling18-Nov-08 21:07 
GeneralRe: Errata - Why new Pin
safnate Malete3-Oct-11 18:50
safnate Malete3-Oct-11 18:50 
GeneralBest article for starters Pin
Stuti Patel1-Aug-06 19:36
Stuti Patel1-Aug-06 19:36 
GeneralProblem in converting function pointers of VC++ to delegate in C#.Net Pin
Stuti Patel1-Aug-06 19:26
Stuti Patel1-Aug-06 19:26 
GeneralNot bad for a first article Pin
Marc Clifton16-Sep-05 5:38
mvaMarc Clifton16-Sep-05 5:38 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.