ToolStripControlHost.OnUnsubscribeControlEvents Method (Control)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Unsubscribes events from the hosted control.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

protected virtual void OnUnsubscribeControlEvents(
	Control control


Type: System.Windows.Forms.Control

The control from which to unsubscribe events.

Override the OnUnsubscribeControlEvents method to unsubscribe events subscribed in OnSubscribeControlEvents.

Raising an event invokes the event handler through a delegate. For more information, see Handling and Raising Events.

The OnUnsubscribeControlEvents method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Notes to Inheritors:

When overriding OnUnsubscribeControlEvents in a derived class, be sure to call the base class's OnUnsubscribeControlEvents method so that registered delegates receive the event.

The following code example demonstrates how to unsubscribe from an event exposed by the hosted control. This code example is part of a larger example provided for the ToolStripControlHost class.

protected override void OnUnsubscribeControlEvents(Control c)
	// Call the base method so the basic events are unsubscribed.

	// Cast the control to a MonthCalendar control.
	MonthCalendar monthCalendarControl = (MonthCalendar) c;

	// Remove the event.
	monthCalendarControl.DateChanged -=
		new DateRangeEventHandler(OnDateChanged);

.NET Framework
Available since 2.0
Return to top