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
Public Sub RemoveHandler (routedEvent As RoutedEvent, handler As Delegate)

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 de contenedor de Common Language Runtime (CLR) 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 CLR.The most common scenario for using this API is when you implement the 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 CLR 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 CLR del -= operador.This behavior is consistent with CLR behavior of the -= operator.

Ni routedEvent ni handler pueden ser null .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 handledEventsToo información de parámetros, que se proporciona si el controlador se agregó por primera vez con la AddHandler(RoutedEvent, Delegate, Boolean) firma que habilita el 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