RoutedEventArgs.InvokeEventHandler(Delegate, Object) Método

Definición

Espacio de nombres:
System.Windows
Ensamblado:
PresentationCore.dll

Cuando se reemplaza en una clase derivada, proporciona una manera de invocar controladores de eventos de una manera específica del tipo, lo que puede aumentar la eficacia sobre la implementación base.

protected:
 virtual void InvokeEventHandler(Delegate ^ genericHandler, System::Object ^ genericTarget);
protected virtual void InvokeEventHandler(Delegate genericHandler, object genericTarget);
abstract member InvokeEventHandler : Delegate * obj -> unit
override this.InvokeEventHandler : Delegate * obj -> unit
Protected Overridable Sub InvokeEventHandler (genericHandler As Delegate, genericTarget As Object)

Parámetros

genericHandler
Delegate

Implementación del controlador o delegado genérico que se va a invocar.

genericTarget
Object

Destino en el que se debe invocar el controlador proporcionado.

Ejemplos

A continuación se muestra el pseudocódigo que ilustra un patrón básico que se puede usar para la implementación. Aquí, MyRoutedEventHandler es una subclase de RoutedEventHandler.

public class MyRoutedEventArgs : RoutedEventArgs 
{
// other members omitted
    protected override void InvokeEventHandler(Delegate genericHandler, object genericTarget) {
        MyRoutedEventHandler handler = (MyRoutedEventHandler) genericHandler;
        handler(genericTarget, this);
    }
}

Public Class MyRoutedEventArgs
    Inherits RoutedEventArgs
' other members omitted
    Protected Overrides Sub InvokeEventHandler(ByVal genericHandler As System.Delegate, ByVal genericTarget As Object)
        Dim handler As MyRoutedEventHandler = CType(genericHandler, MyRoutedEventHandler)
        handler(genericTarget, Me)
    End Sub
End Class

Comentarios

La implementación base incorpora reflexión para determinar el controlador adecuado para cualquier caso en el que el controlador no sea literalmente RoutedEventHandler, y este paso de reflexión tiene algunas consecuencias de rendimiento. Las invocaciones se pueden hacer más eficaces sin depender de la reflexión. Este es el escenario que motiva que este método esté disponible para cualquier clase de argumentos de evento enrutado que elija reemplazarlo. Las implementaciones no deben llamar a la base para este método, ya que la implementación ya debe ser responsable de invocar los controladores seguros de tipos.

Notas a los desarrolladores de herederos

Este método está diseñado para reemplazarse por las clases de datos de eventos derivadas para proporcionar una invocación más eficaz de sus delegados. La implementación debe convertir el proporcionado genericHandler en el delegado específico del tipo y, a continuación, invocar ese controlador.

La implementación predeterminada intentará invocar el controlador proporcionado, intentando convertirlo como RoutedEventHandler. Si se proporciona o genericHandlergenericTarget como null, se producirán excepciones.

Se aplica a