ContentElement.RemoveHandler(RoutedEvent, Delegate) ContentElement.RemoveHandler(RoutedEvent, Delegate) ContentElement.RemoveHandler(RoutedEvent, Delegate) Method

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 RoutedEvent RoutedEvent

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

handler
Delegate Delegate 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 usar este APIAPI es cuando implementa el Common Language Runtime (CLR)common language runtime (CLR) evento "contenedor" que está asociado a un evento enrutado personalizado específicamente al implementar la lógica de "remove" para los controladores en el CLRCLR nivel.The most common scenario for using this APIAPI 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. El ejemplo que sigue a esta sección muestra este escenario de comentarios.The example that follows this remarks section illustrates this scenario.

Llamar a este método no tiene ningún efecto si no hubiera ningún controlador registrado con los criterios que coinciden con los parámetros de entrada para 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 se asocia más de un controlador que coinciden con los criterios, solo el primer controlador en caso de que se quita el almacén de controladores.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 CLRCLR comportamiento de la -= operador.This behavior is consistent with CLRCLR behavior of the -= operator.

Ni routedEvent ni handler puede ser null.Neither routedEvent nor handler may be null. Se intenta proporcionar cualquiera de los valores como null , se producirá una excepción.Attempting to provide either value as null will raise an exception.

Este método omite la handledEventsToo agrega información de parámetros, que se proporciona si el controlador fue el primero con el AddHandler(RoutedEvent, Delegate, Boolean) firma que permite un control de 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: