Updated: November 2007
Events enable a class or object to notify other classes or objects when something of interest occurs. The class that sends (or raises) the event is called the publisher and the classes that receive (or handle) the event are called subscribers.
In a typical C# Windows Forms or Web application, you subscribe to events raised by controls such as buttons and list boxes. You can use the Visual C# integrated development environment (IDE) to browse the events that a control publishes and select the ones that you want to handle. The IDE automatically adds an empty event handler method and the code to subscribe to the event. For more information, see How to: Subscribe to and Unsubscribe from Events (C# Programming Guide).
Events have the following properties:
The publisher determines when an event is raised; the subscribers determine what action is taken in response to the event.
An event can have multiple subscribers. A subscriber can handle multiple events from multiple publishers.
Events that have no subscribers are never raised.
Events are typically used to signal user actions such as button clicks or menu selections in graphical user interfaces.
When an event has multiple subscribers, the event handlers are invoked synchronously when an event is raised. To invoke events asynchronously, see Calling Synchronous Methods Asynchronously.
Events can be used to synchronize threads.
In the .NET Framework class library, events are based on the EventHandler delegate and the EventArgs base class.
For more information, see:
How to: Subscribe to and Unsubscribe from Events (C# Programming Guide)
How to: Publish Events that Conform to .NET Framework Guidelines (C# Programming Guide)
How to: Raise Base Class Events in Derived Classes (C# Programming Guide)
How to: Implement Interface Events (C# Programming Guide)
Thread Synchronization (C# Programming Guide)
How to: Use a Dictionary to Store Event Instances (C# Programming Guide)
How to: Implement Custom Event Accessors (C# Programming Guide)
Events Sample
Event Design
For more information, see the following sections in the C# Language Specification:
1.6.7.4 Events
10.2.9.2 Member Names Reserved for Events
10.8 Events
13.2.3 Interface Events
