ToolStripControlHost.OnUnsubscribeControlEvents(Control) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Elimina la suscripción de eventos procedentes del control hospedado.

protected:
 virtual void OnUnsubscribeControlEvents(System::Windows::Forms::Control ^ control);

protected virtual void OnUnsubscribeControlEvents (System.Windows.Forms.Control control);

abstract member OnUnsubscribeControlEvents : System.Windows.Forms.Control -> unit
override this.OnUnsubscribeControlEvents : System.Windows.Forms.Control -> unit

Protected Overridable Sub OnUnsubscribeControlEvents (control As Control)

Parámetros

control

Control

El control de cuyos eventos se eliminará la suscripción.

Ejemplos

En el ejemplo de código siguiente se muestra cómo cancelar la suscripción de un evento expuesto por el control hospedado. Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la ToolStripControlHost clase .

void OnUnsubscribeControlEvents( System::Windows::Forms::Control^ c )
{
   
   // Call the base method so the basic events are unsubscribed.
   __super::OnUnsubscribeControlEvents( c );
   
   // Cast the control to a MonthCalendar control.
   MonthCalendar^ monthCalendarControl = (MonthCalendar^)c;
   
   // Remove the event.
   monthCalendarControl->DateChanged -= gcnew DateRangeEventHandler( this, &ToolStripMonthCalendar::HandleDateChanged );
}

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);
}

Protected Overrides Sub OnUnsubscribeControlEvents(ByVal c As Control)
    ' Call the base method so the basic events are unsubscribed.
    MyBase.OnUnsubscribeControlEvents(c)

    ' Cast the control to a MonthCalendar control.
    Dim monthCalendarControl As MonthCalendar = _
        CType(c, MonthCalendar)

    ' Remove the event.
    RemoveHandler monthCalendarControl.DateChanged, _
        AddressOf HandleDateChanged

End Sub

Comentarios

Invalide el método para cancelar la OnUnsubscribeControlEvents suscripción a eventos suscritos en OnSubscribeControlEvents.

Cuando se genera un evento, se invoca el controlador de eventos a través de un delegado. Para obtener más información, consulte controlar y provocar eventos.

El método OnUnsubscribeControlEvents también permite que las clases derivadas controlen el evento sin adjuntar ningún delegado. Ésta es la técnica preferida para controlar el evento en una clase derivada.

Notas a los desarrolladores de herederos

Al reemplazar OnUnsubscribeControlEvents(Control) en una clase derivada, asegúrese de llamar al método OnUnsubscribeControlEvents(Control) de la clase base para que los delegados registrados reciban el evento.