Exportar (0) Imprimir
Expandir todo
Expandir Minimizar
Este artículo se tradujo de forma manual. Mueva el puntero sobre las frases del artículo para ver el texto original.
Traducción
Original

EventHandler (Delegado)

Representa el método que controlará eventos que no tienen datos de evento.

Espacio de nombres:  System
Ensamblado:  mscorlib (en mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public delegate void EventHandler(
	Object sender,
	EventArgs e
)

Parámetros

sender
Tipo: System.Object
Origen del evento.
e
Tipo: System.EventArgs
Clase EventArgs que no contiene datos de evento.

El modelo de evento de .NET Framework se basa en la existencia de un delegado de eventos que conecte un evento a su controlador. Para generar un evento, se requieren dos elementos:

  • Delegado que identifica el método que proporciona la respuesta al evento.

  • Clase que contiene los datos de eventos.

El delegado es un tipo que define una firma; es decir, el tipo del valor devuelto y los tipos de la lista de parámetros de un método. Puede utilizar el tipo delegado para declarar una variable que puede hacer referencia a cualquier método con la misma firma que el delegado.

La firma estándar del delegado de un controlador de eventos define un método que no devuelve ningún valor, cuyo primer parámetro es de tipo Object y hace referencia a la instancia que genera el evento, y cuyo segundo parámetro se deriva del tipo EventArgs y contiene los datos de eventos. Si el evento no genera datos de eventos, el segundo parámetro es tan sólo una instancia de EventArgs. De lo contrario, el segundo parámetro es un tipo personalizado derivado de EventArgs y proporciona los campos o las propiedades necesarias para contener los datos de evento.

EventHandler es un delegado predefinido que representa específicamente un método de control de eventos para un evento que no genera datos. Si su evento genera datos, debe suministrar su propio tipo de datos de evento personalizado y crear un delegado donde el tipo del segundo parámetro sea el tipo personalizado o utilizar la clase de delegado genérico EventHandler<TEventArgs> y sustituir el tipo personalizado por el parámetro de tipo genérico.

Para asociar el evento al método que lo controlará, hay que agregar una instancia del delegado al evento. Siempre que se produzca el evento, se llamará a su controlador, a menos que se quite el delegado.

Para obtener más información sobre los delegados del controlador de eventos, vea Eventos y delegados.

En el ejemplo de código siguiente se muestra la declaración de un delegado del controlador de eventos que no utiliza datos de evento. La clase EventHandler es el tipo del delegado del evento, sender es el objeto que genera el evento y e es un objeto de datos de evento que no contiene datos. La segunda línea de código del ejemplo define el miembro del evento de la clase para un evento que no tiene datos.


public delegate void EventHandler(Object sender, EventArgs e);
public event EventHandler NoDataEventHandler;


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Compatible con:

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft