Events in C#

Events are members of the class that raises them. When some thing happens a class can raise an event, which have a message that contain informations about the event (event arguments) and send them out to the rest of the application, other parts of the application can respond to the event by excuting methods called event handlers.

Event handler is a method that has the same signature as the event and this method is executed when the event occurs.To define an event you need first to define a delegate that contains the methods that will be called when the event raised, and then you define the event based on that delegate.

Raising an events is a simple step. First you check the event agaist a null value to ensure that the caller has registered with the event, and then you fire the event by specifying the event by name as well as any required parameters as defined by the associated delegate.

Example

if (MyEvent != null) MyEvent(message);

So far so good, in the previous section you saw how to define an event and the delegate associated with it and how to raise this event.

Now you will see how the other parts of the application can respond to the event. To do this you just need to register the event handlers.

when you want to register an event handler with an event you must follow this pattern:MyClass myClass1 = new MyClass();MyClass.MyDelegate del = new MyClass.MyDelegate(myClass1_MyEvent);myClass1.MyEvent += del;

or you can do this in one line of code

myClass1.MyEvent += new MyClass.MyDelegate(myClass1_MyEvent);

//thisisthe event handler

//this method will be executed when the event raised.

staticvoid myClass1_MyEvent(string message)

{

//do something to respond to the event.}

Let's see a full example to demonstrate the concept:

namespace EventsInCSharp

{

publicclassMyClass

{

publicdelegatevoidMyDelegate(string message);

publiceventMyDelegate MyEvent;

//this method will be used to raise the event.

publicvoid RaiseEvent(string message)

{

if (MyEvent != null)

MyEvent(message);

}

}

classProgram

{

staticvoid Main(string[] args)

{

MyClass myClass1 = newMyClass();

myClass1.MyEvent += newMyClass.MyDelegate(myClass1_MyEvent);

Console.WriteLine("Please enter a message\n");

string msg = Console.ReadLine();

//here is we raise the event.

myClass1.RaiseEvent(msg);

Console.Read();

}

//this method will be executed when the event raised.

staticvoid myClass1_MyEvent(string message)

{

Console.WriteLine("Your Message is: {0}", message);

}

}

}

we are doing great, but what if you want to define your event and it's associated delegate to mirrors Microsoft's recommended event pattern. To do so you must follow this patten:

publicdelegatevoidMyDelegate(object sender, MyEventArgs e);

publicevent MyDelegate MyEvent;

As you can see the first parameter of the delegate is a System.Object, while the second parameter is a type deriving from System.EventArgs.

The System.Object parameter represents a reference to the object that sent the event(such as MyClass), while the second parameter represents information regarding the event.

If you define a simple event that is not sending any custom information, you can pass an instance of EventArgs directly.let's see an example: namespace MicrosoftEventPattern

{

publicclassMyClass

{

publicdelegatevoidMyDelegate(object sender, MyEventArgs e);

publiceventMyDelegate MyEvent;

publicclassMyEventArgs : EventArgs

{

publicreadonlystring message;

public MyEventArgs(string message)

{

this.message = message;

}

}

//this method will be used to raise the event.

publicvoid RaiseEvent(string msg)

{

if (MyEvent != null)

MyEvent(this, newMyClass.MyEventArgs(msg));

}

}

classProgram

{

staticvoid Main(string[] args)

{

MyClass myClass1 = newMyClass();

myClass1.MyEvent += newMyClass.MyDelegate(myClass1_MyEvent);

Console.WriteLine("Please enter a message\n");

string msg = Console.ReadLine();

//here is we raise the event.

myClass1.RaiseEvent(msg);

Console.Read();

}

staticvoid myClass1_MyEvent(object sender, MyClass.MyEventArgs e)

{

if (sender isMyClass)

{

MyClass myClass = (MyClass)sender;

Console.WriteLine("Your Message is: {0}", e.message);

}

}

}

}

we are done now, in my next article i'll show you how to define your custom event to use it in a custom control in a windows application.