ContentElement.RemoveHandler(RoutedEvent, Delegate) Método

Definición

Quita el controlador de eventos enrutados especificado de este elemento.Removes the specified routed event handler from this element.

public:
 virtual void RemoveHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);
public void RemoveHandler (System.Windows.RoutedEvent routedEvent, Delegate handler);
abstract member RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit
override this.RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit

Parámetros

routedEvent
RoutedEvent

Identificador del evento enrutado para el que se asocia el controlador.The identifier of the.routed event for which the handler is attached.

handler
Delegate

Implementación de controlador específica que se va a quitar de la colección de controladores de eventos de este elemento.The specific handler implementation to remove from the event handler collection on this element.

Implementaciones

Comentarios

El escenario más común para el uso de esta API es cuando se implementa el evento Common Language Runtime (CLR)common language runtime (CLR) "contenedor" que está asociado a un evento enrutado personalizado, específicamente cuando se implementa la lógica de "quitar" para los controladores en el nivel de CLRCLR.The most common scenario for using this API is when you implement the Common Language Runtime (CLR)common language runtime (CLR) "wrapper" event that is associated with a custom routed event, specifically when you implement the "remove" logic for handlers at the CLRCLR level. En el ejemplo siguiente se muestra este escenario.The example that follows this remarks section illustrates this scenario.

Llamar a este método no tiene ningún efecto si no hay controladores registrados con criterios que coincidan con los parámetros de entrada de la llamada al método.Calling this method has no effect if there were no handlers registered with criteria that match the input parameters for the method call.

Si hay más de un controlador asociado que coincida con los criterios, solo se quita el primer controlador del almacén de controladores de eventos.If more than one handler is attached that matched the criteria, only the first handler in the event handler store is removed. Este comportamiento es coherente con el comportamiento de CLRCLR del operador -=.This behavior is consistent with CLRCLR behavior of the -= operator.

No se puede nullni routedEvent ni handler.Neither routedEvent nor handler may be null. Si se intenta proporcionar cualquier valor como null, se producirá una excepción.Attempting to provide either value as null will raise an exception.

Este método omite la información del parámetro handledEventsToo, que se proporciona si el controlador se agregó por primera vez con la AddHandler(RoutedEvent, Delegate, Boolean) firma que permite el control de los eventos ya controlados.This method ignores the handledEventsToo parameter information, which is provided if the handler was first added with the AddHandler(RoutedEvent, Delegate, Boolean) signature that enables handling of already-handled events. Se quita cualquier tipo de controlador.Either type of handler is removed.

Se aplica a

Consulte también: