Click here to Skip to main content
13,449,448 members (41,422 online)
Click here to Skip to main content
Add your own
alternative version


27 bookmarked
Posted 25 Apr 2001

Delegates in managed C++

, 15 Oct 2001
Rate this:
Please Sign up or sign in to vote.
This sample demonstrates single- and multi-cast delegates using C++, including declaration, creation and usage, and a discussion on type safety.
<!-- Download Links -->


Delegates are .NET's type safe equivalent to function pointers. Delegates go further than this though. Instead of a single delegate having the ability to point to, and invoke, a single function, delegates in .NET give you the ability to have a single delegate point to a list of methods, each which will be called in turn.

Creating a single cast delegate

A single cast delegate is one which points to a single method. To create a delegate you must first declare a delegate type that has the same signature as the methods you wish it to invoke. For instance, if we wished to have a delegate call a function that took a String* as a parameter and returned an int, we might declare it as

__delegate int MyDelegate(String *str);

Single cast delegates are implicitely derived from Delegate. To use a delegate to invoke your methods you must create an instance of the delegate and pass in an object and the method of that object you wish to call.

For instance, suppose we had a managed class

__gc class MyClass 
	int MethodA(String *str) 
		Console::WriteLine(S"MyClass::MethodA - The value of str is: {0}", str);
		return str->Length;

we could declare an object of type MyClass and a delegate to call the objects methods like

MyClass *pMC = new MyClass();
MyDelegate *pDelegate = new MyDelegate(pMC, &MyClass::MethodA);

To invoke the object's method using the delegate is as simple as calling

pDelegate->Invoke("Invoking MethodA");

This would output:

MyClass::MethodA - The value of str is: Invoking MethodA

Creating a multi cast delegate

Multi cast delegates allow you to chain together methods so that each one will be called in turn when the delegate is invoked. To create a multicast method use the static Delegate::Combine method to combine delegates into a multicast delegate.

When creating multicast delegates in beta 1, you had to declare your delegates you wished to combine as multicast delegates using the __delegate(multicast) directive. This creates a delegate derived from MulticastDelegate. In beta 2 you do not use the (multicast) specifier, and you can use Delegate::Combine your single cast delegates into a multicast delegate.

Below is some sample code showing 2 multicast delegates being combined (beta 2)

// Declare a delegate
__delegate int MyDelegate(String *str);

// Create a simple managed reference class
__gc class MyClass 
    int MethodA(String *str) 
        Console::WriteLine(S"MyClass::MethodA - The value of str is: {0}", str);
        return str->Length;

    int MethodB(String* str) 
        Console::WriteLine(S"MyClass::MethodB - The value of str is: {0}", str);
        return str->Length * 2;


MyClass *pMC = new MyClass();
MyDelegate *pDelegate1 = new MyDelegate(pMC, &MyClass::MethodA);
MyDelegate *pDelegate2 = new MyDelegate(pMC, &MyClass::MethodB);

MyDelegate *pMultiDelegate = 
	static_cast<MyDelegate *>(Delegate::Combine(pDelegate, pDelegate2));

When you invoke the multicast delegate pMultiDelegate it will first call MyClass::MethodA, then MyClass::MethodB. For instance, calling

pMultiDelegate->Invoke("Invoking Multicast delegate");

would result in

MyClass::MethodA - The value of str is: Invoking multicast delegate
MyClass::MethodB - The value of str is: Invoking multicast delegate

Type Safety

Delegates are inherently type safe. You cannot compile calls to a delegate using the wrong parameters, or assign the return value of a delegate to a type that cannot be implicitly cast from the return type of the method the delegate is calling. Because an object and method are passed to the delegates constructor, the compiler has all the information it needs to ensure that errors caused by mismatched parameters and return types do not occur.


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


About the Author

Chris Maunder
Founder CodeProject
Canada Canada
Chris is the Co-founder, Administrator, Architect, Chief Editor and Shameless Hack who wrote and runs The Code Project. He's been programming since 1988 while pretending to be, in various guises, an astrophysicist, mathematician, physicist, hydrologist, geomorphologist, defence intelligence researcher and then, when all that got a bit rough on the nerves, a web developer. He is a Microsoft Visual C++ MVP both globally and for Canada locally.

His programming experience includes C/C++, C#, SQL, MFC, ASP, ASP.NET, and far, far too much FORTRAN. He has worked on PocketPCs, AIX mainframes, Sun workstations, and a CRAY YMP C90 behemoth but finds notebooks take up less desk space.

He dodges, he weaves, and he never gets enough sleep. He is kind to small animals.

Chris was born and bred in Australia but splits his time between Toronto and Melbourne, depending on the weather. For relaxation he is into road cycling, snowboarding, rock climbing, and storm chasing.

You may also be interested in...


Comments and Discussions

Generalplease show C++ equivelent Pin
TomM8-Apr-02 3:57
memberTomM8-Apr-02 3:57 
GeneralManaged C++ / C# Pin
Anonymous19-Oct-01 1:27
memberAnonymous19-Oct-01 1:27 
GeneralC++ dos not need this Pin
Joaquín M López Muñoz18-Oct-01 10:15
memberJoaquín M López Muñoz18-Oct-01 10:15 
QuestionAnd funtion objects? Pin
Nemanja Trifunovic17-Oct-01 5:56
memberNemanja Trifunovic17-Oct-01 5:56 
QuestionWhy C++ managed extensions? Pin
Gerald Schwab30-Apr-01 18:40
memberGerald Schwab30-Apr-01 18:40 
AnswerRe: Why C++ managed extensions? Pin
Chris Maunder30-Apr-01 18:55
memberChris Maunder30-Apr-01 18:55 
GeneralRe: Why C++ managed extensions? Pin
Gerald Schwab30-Apr-01 19:12
memberGerald Schwab30-Apr-01 19:12 
GeneralRe: Why C++ managed extensions? Pin
Soliant19-Jun-02 11:09
memberSoliant19-Jun-02 11:09 
GeneralRe: Why C++ managed extensions? Pin
Christopher Lord17-Aug-03 11:57
memberChristopher Lord17-Aug-03 11:57 
GeneralScooter Pin
CodeGuy26-Apr-01 5:41
memberCodeGuy26-Apr-01 5:41 
GeneralRe: Scooter Pin
Chris Maunder26-Apr-01 16:41
memberChris Maunder26-Apr-01 16:41 

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.

Permalink | Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.180318.3 | Last Updated 16 Oct 2001
Article Copyright 2001 by Chris Maunder
Everything else Copyright © CodeProject, 1999-2018
Layout: fixed | fluid