ContentElement.RemoveHandler(RoutedEvent, Delegate) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Quita el controlador de eventos enrutados especificado de este elemento.
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 -> unitPublic Sub RemoveHandler (routedEvent As RoutedEvent, handler As Delegate)Parámetros
- routedEvent
- RoutedEvent
Identificador del evento enrutado para el que se asocia el controlador.
- handler
- Delegate
Implementación de controlador específica que se va a quitar de la colección de controladores de eventos de este elemento.
Implementaciones
Comentarios
El escenario más común para usar esta API es cuando se implementa el evento "contenedor" de Common Language Runtime (CLR) asociado a un evento enrutado personalizado, específicamente cuando se implementa la lógica "remove" para los controladores en el nivel clR. El ejemplo que sigue a esta sección de comentarios ilustra este escenario.
Llamar a este método no tiene ningún efecto si no había controladores registrados con criterios que coincidan con los parámetros de entrada de la llamada al método.
Si se adjunta más de un controlador que coincida con los criterios, solo se quita el primer controlador del almacén de controladores de eventos. Este comportamiento es coherente con el comportamiento clR del -= operador.
Ni routedEvent ni handler pueden ser null. Si se intenta proporcionar cualquiera de los valores, se null producirá una excepción.
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 permite el control de eventos ya controlados. Se quita cualquier tipo de controlador.