Export (0) Print
Expand All

ToolStripControlHost.OnUnsubscribeControlEvents Method

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
)

Parameters

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. 
			base.OnUnsubscribeControlEvents(c);

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

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Show:
© 2015 Microsoft