This documentation is archived and is not being maintained.

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 Raising an Event.

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, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: