Provocar un evento
Si desea que su clase genere un evento, debe proporcionar los tres elementos siguientes:
Una clase que proporciona datos de eventos.
Un delegado de eventos.
La clase que genera el evento.
Definir una clase para proporcionar datos de eventos
Por convención, en .NET Framework, cuando se genera un evento, pasa los datos de eventos a sus controladores de eventos. Los datos de eventos los proporciona la clase System.EventArgs o una clase que se deriva de ella.
A menudo, un evento no tiene datos personalizados; el hecho de que se desencadenara el evento proporciona toda la información que los controladores de eventos necesitan. En este caso, el evento puede pasar un objeto EventArgs a sus controladores. La clase EventArgs solo tiene un único miembro, Empty, que no se hereda de System.Object. Se puede usar para crear instancias de una nueva clase EventArgs.
Si un evento tiene datos personalizados, puede pasar a los controladores de eventos una instancia de una clase derivada de EventArgs. Dependiendo de los datos precisos que el evento pase a los controladores, quizás pueda usar una clase de datos de eventos existente en .NET Framework. Por ejemplo, si su controlador de eventos permite la acción asociada al evento que se va a cancelar, puede usar la clase CancelEventArgs.
Cuando necesite proporcionar datos personalizados a los controladores y no haya disponible una clase existente, puede definir su propia clase de datos de eventos. Se debe derivar de System.EventArgs. Por convención, esta clase se denomina EventNameEventArgs. En el ejemplo siguiente se muestra ese tipo de clase de datos de eventos personalizada. Define una clase denominada AlarmEventArgs que proporciona dos elementos de datos a los controladores de eventos: la propiedad Time de solo lectura, que indica cuándo se desencadenó la alarma, y la propiedad Snooze, que indica si la alarma se debe activar de nuevo después de un intervalo designado o si se deben cancelar las alarmas futuras.
Public Class AlarmEventArgs : Inherits EventArgs
Private alarmTime As Date
Private snoozeOn As Boolean = True
Public Sub New(time As Date)
Me.alarmTime = time
End Sub
Public ReadOnly Property Time As Date
Get
Return Me.alarmTime
End Get
End Property
Public Property Snooze As Boolean
Get
Return Me.snoozeOn
End Get
Set
Me.snoozeOn = value
End Set
End Property
End Class
public class AlarmEventArgs : EventArgs
{
private DateTime alarmTime;
private bool snoozeOn = true;
public AlarmEventArgs(DateTime time)
{
this.alarmTime = time;
}
public DateTime Time
{
get { return this.alarmTime; }
}
public bool Snooze
{
get { return this.snoozeOn; }
set { this.snoozeOn = value; }
}
}
public ref class AlarmEventArgs : public EventArgs
{
private:
System::DateTime^ alarmTime;
bool snoozeOn;
public:
AlarmEventArgs(System::DateTime^ time)
{
this->alarmTime = time;
this->snoozeOn = true;
}
property DateTime^ Time
{
System::DateTime^ get()
{ return this->alarmTime; }
}
property bool Snooze
{
bool get()
{ return this->snoozeOn; }
void set(bool snooze)
{ this->snoozeOn = snooze; }
}
};
Definir un delegado para el evento
Un delegado de eventos se usa para definir la firma del evento. Un delegado de eventos determinado corresponde normalmente a una clase de datos de eventos concreta. Por convención, los eventos de .NET Framework tienen la firma EventName(sender, e), donde sender es un Object que proporciona una referencia a la clase o estructura que desencadenó el evento, y e es un objeto EventArgs o un objeto derivado de EventArgs que proporciona datos de eventos. La definición de delegado suele tomar el formato EventNameHandler(sender, e).
Si está usando una clase de datos de eventos que ya está definida en la biblioteca de clases de .NET Framework o en una biblioteca de otro fabricante, es probable que en esa biblioteca también esté definido un delegado de eventos correspondiente. Por ejemplo, el delegado de EventHandler se puede usar junto con la clase EventArgs. Del mismo modo, el delegado de CancelEventHandler se puede usar junto con la clase CancelEventArgs.
Si define una clase de datos de eventos personalizada, también puede definir un delegado personalizado para definir la firma del evento o puede usar el delegado Action<T1, T2> genérico.
En el ejemplo siguiente se define un delegado de eventos denominado AlarmEventHandler.
Public Delegate Sub AlarmEventHandler(sender As Object, e As AlarmEventArgs)
public delegate void AlarmEventHandler(object sender, AlarmEventArgs e);
public delegate void AlarmEventHandler(System::Object^ sender, AlarmEventArgs^ e);
Definir una clase para generar el evento
La clase que genera el evento debe proporcionar la declaración de evento y definir un método que genera el evento. Además, debe proporcionar cierta lógica para generar el evento en una propiedad o en un método de clase.
Para definir un miembro de evento en su clase se emplea la palabra clave event en C# o la instrucción Event en Visual Basic. Cuando el compilador encuentra una declaración de evento en la clase, crea un miembro privado como:
private EventNameHandler eh = null;
El compilador también crea los dos métodos públicos add_EventName y remove_EventName. Estos métodos son enlaces de eventos que permiten combinar o quitar delegados del delegado de evento eh. El programador oculta los detalles.
Nota
En lenguajes que no sean C# y Visual Basic 2005, puede que el compilador no genere automáticamente el código correspondiente a un miembro de evento, y que se tengan que definir explícitamente los enlaces de eventos y el campo del delegado privado.
En el ejemplo siguiente se declara un evento denominado AlarmEvent. Se ha extraído del ejemplo para una clase denominada Alarm cuyo código fuente completo se muestra debajo. Observe que tiene la firma del delegado AlarmEventHandler.
Event AlarmEvent As AlarmEventHandler
public event AlarmEventHandler AlarmEvent;
public:
event AlarmEventHandler^ AlarmEvent;
Cuando haya definido su implementación de evento, deberá determinar cuándo provocar el evento. Para generar el evento se llama al método protegido OnEventName en la clase que definía el evento o en una clase derivada. A continuación, el método OnEventName genera el evento.
Nota
El método protegido OnEventName también permite que las clases derivadas reemplacen el evento sin adjuntarle un delegado.Una clase derivada siempre debe llamar al método OnEventName de la clase base para asegurarse de que los delegados registrados reciben el evento.
En el ejemplo siguiente se define el método OnAlarmEvent, que es responsable de generar el evento AlarmEvent.
Protected Sub OnAlarmEvent(e As AlarmEventArgs)
RaiseEvent AlarmEvent(Me, e)
End Sub
protected void OnAlarmEvent(AlarmEventArgs e)
{
AlarmEvent(this, e);
}
protected:
void OnAlarmEvent(AlarmEventArgs^ e)
{
AlarmEvent(this, e);
}
En el ejemplo siguiente se define un método denominado Set que contiene la lógica para desencadenar el evento llamando al método OnAlarmEvent. Si las horas y los minutos de la hora de la alarma son iguales que las horas y los minutos de la hora actual, el método Set crea una instancia de un objeto AlarmEventArgs y le proporciona la hora a la que sonó la alarma. Una vez que se ejecutan los controladores de eventos, comprueba el valor de la propiedad Snooze. Si Snooze es false, no se va a generar ningún evento de alarma más, por lo que el método Set puede finalizar. Si Snooze es true, el valor de la propiedad Interval incrementa la hora a la que va a sonar la alarma.
Public Sub [Set]()
Do
System.Threading.Thread.Sleep(2000)
Dim currentTime As DateTime = Date.Now
' Test whether it is time for the alarm to go off.
If currentTime.Hour = alarmTime.Hour And _
currentTime.Minute = AlarmTime.Minute Then
Dim args As New AlarmEventArgs(currentTime)
OnAlarmEvent(args)
If args.Snooze = False Then
Exit Sub
Else
Me.alarmTime = Me.alarmTime.AddMinutes(Me.interval)
End If
End If
Loop
End Sub
public void Set()
{
while (true) {
System.Threading.Thread.Sleep(2000);
DateTime currentTime = DateTime.Now;
// Test whether it is time for the alarm to go off.
if (currentTime.Hour == alarmTime.Hour &&
currentTime.Minute == alarmTime.Minute)
{
AlarmEventArgs args = new AlarmEventArgs(currentTime);
OnAlarmEvent(args);
if (! args.Snooze)
return;
else
this.alarmTime = this.alarmTime.AddMinutes(this.interval);
}
}
}
void Set()
{
do {
Thread::Sleep(2000);
System::DateTime^ currentTime = DateTime::Now;
// Test whether it's time for the alarm to go off.
if (currentTime->Hour == alarmTime->Hour && currentTime->Minute == alarmTime->Minute)
{
AlarmEventArgs^ args = gcnew AlarmEventArgs(currentTime);
OnAlarmEvent(args);
if (args->Snooze == false)
return;
else
this->alarmTime = this->alarmTime->AddMinutes(this->interval);
}
} while (true);
}
En el ejemplo siguiente se incluye todo el código fuente para la clase Alarm.
Public Class Alarm
Private alarmTime As Date
Private interval As Integer = 10
Event AlarmEvent As AlarmEventHandler
Public Sub New(time As Date)
Me.New(time, 10)
End Sub
Public Sub New(time As Date, interval As Integer)
Me.alarmTime = time
Me.interval = interval
End Sub
Public Sub [Set]()
Do
System.Threading.Thread.Sleep(2000)
Dim currentTime As DateTime = Date.Now
' Test whether it is time for the alarm to go off.
If currentTime.Hour = alarmTime.Hour And _
currentTime.Minute = AlarmTime.Minute Then
Dim args As New AlarmEventArgs(currentTime)
OnAlarmEvent(args)
If args.Snooze = False Then
Exit Sub
Else
Me.alarmTime = Me.alarmTime.AddMinutes(Me.interval)
End If
End If
Loop
End Sub
Protected Sub OnAlarmEvent(e As AlarmEventArgs)
RaiseEvent AlarmEvent(Me, e)
End Sub
End Class
public class Alarm
{
private DateTime alarmTime;
private int interval = 10;
public event AlarmEventHandler AlarmEvent;
public Alarm(DateTime time) : this(time, 10)
{
}
public Alarm(DateTime time, int interval)
{
this.alarmTime = time;
this.interval = interval;
}
public void Set()
{
while (true) {
System.Threading.Thread.Sleep(2000);
DateTime currentTime = DateTime.Now;
// Test whether it is time for the alarm to go off.
if (currentTime.Hour == alarmTime.Hour &&
currentTime.Minute == alarmTime.Minute)
{
AlarmEventArgs args = new AlarmEventArgs(currentTime);
OnAlarmEvent(args);
if (! args.Snooze)
return;
else
this.alarmTime = this.alarmTime.AddMinutes(this.interval);
}
}
}
protected void OnAlarmEvent(AlarmEventArgs e)
{
AlarmEvent(this, e);
}
}
public ref class Alarm
{
private:
System::DateTime^ alarmTime;
int interval;
public:
event AlarmEventHandler^ AlarmEvent;
Alarm(System::DateTime^ time) : alarmTime(time), interval(10) { };
Alarm(System::DateTime^ time, int interval) : alarmTime(time), interval(interval) {};
void Set()
{
do {
Thread::Sleep(2000);
System::DateTime^ currentTime = DateTime::Now;
// Test whether it's time for the alarm to go off.
if (currentTime->Hour == alarmTime->Hour && currentTime->Minute == alarmTime->Minute)
{
AlarmEventArgs^ args = gcnew AlarmEventArgs(currentTime);
OnAlarmEvent(args);
if (args->Snooze == false)
return;
else
this->alarmTime = this->alarmTime->AddMinutes(this->interval);
}
} while (true);
}
protected:
void OnAlarmEvent(AlarmEventArgs^ e)
{
AlarmEvent(this, e);
}
};
Vea también
Tareas
Cómo: Provocar y utilizar eventos
Cómo: Implementar eventos en una clase