CKTIS / C#
System.EventHandler<TEventArgs> y System.EventArgs
Elige el delegado adecuado para un evento con o sin datos y quita los controladores que ya no necesites.
Versión: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxis
// .NET 8 delegate signatures in namespace System (already provided by .NET):
public delegate void EventHandler<TEventArgs>(object? sender, TEventArgs e);
public delegate void EventHandler(object? sender, EventArgs e);
// In a publisher class, with using System; and a custom MessageEventArgs : EventArgs:
public event EventHandler<MessageEventArgs>? MessagePublished;
public event EventHandler? Flushed;
// Inside an instance method of that publisher:
MessagePublished?.Invoke(this, new MessageEventArgs("Build complete"));
Flushed?.Invoke(this, EventArgs.Empty);System.EventHandler<TEventArgs> es el tipo delegado que se usa para declarar un evento que transporta datos. Un controlador devuelve void y recibe object? sender, normalmente el objeto que desencadena el evento (puede ser null), y TEventArgs e. System.EventArgs es una clase base para datos de eventos, no un delegado. En C# 12 con .NET 8, el delegado no exige que TEventArgs herede de EventArgs, pero hacerlo es la convención habitual de .NET para las clases de datos personalizadas.
En un concentrador de notificaciones, declara MessagePublished con EventHandler<MessageEventArgs>. La clase MessageEventArgs : EventArgs expone la propiedad de solo lectura Message, así que el controlador puede leer e.Message sin una conversión de tipo. Para Flushed, usa el tipo no genérico independiente System.EventHandler: el segundo parámetro sigue siendo de tipo EventArgs, y el publicador pasa EventArgs.Empty, una instancia compartida sin datos adicionales, en lugar de null.
El código externo se suscribe con += y cancela la suscripción con -=, pero no puede desencadenar el evento directamente. La clase que declara el evento lo desencadena con ?.Invoke(this, e), que omite la llamada si no hay suscriptores. Una invocación normal del delegado es síncrona. Si un controlador lanza una excepción que no captura, esta se propaga al código llamador y los controladores posteriores de la lista no se ejecutan.
Usa el mismo método al suscribirte y al cancelar la suscripción. Si usas una lambda, guarda el delegado que utilizaste al suscribirte. Cancela la suscripción cuando ya no necesites las notificaciones, especialmente si el publicador vive más tiempo que el suscriptor: el delegado del publicador puede mantener vivo al objeto suscriptor.
Ejemplos
#nullable enable
using System;
var hub = new NotificationHub();
hub.MessagePublished += OnMessagePublished;
hub.Flushed += OnFlushed;
hub.Publish("Build complete");
hub.Flush();
hub.MessagePublished -= OnMessagePublished;
hub.Flushed -= OnFlushed;
hub.Publish("Not printed");
hub.Flush();
static void OnMessagePublished(object? sender, MessageEventArgs e)
=> Console.WriteLine(e.Message);
static void OnFlushed(object? sender, EventArgs e)
=> Console.WriteLine("Flushed");
sealed class MessageEventArgs : EventArgs
{
public MessageEventArgs(string message) => Message = message;
public string Message { get; }
}
sealed class NotificationHub
{
public event EventHandler<MessageEventArgs>? MessagePublished;
public event EventHandler? Flushed;
public void Publish(string message)
=> MessagePublished?.Invoke(this, new MessageEventArgs(message));
public void Flush()
=> Flushed?.Invoke(this, EventArgs.Empty);
}Resultado
Build complete Flushed
`NotificationHub` expone dos eventos independientes. Las primeras llamadas a `Publish` y `Flush` imprimen `Build complete` y `Flushed`, respectivamente. Una vez quitados ambos controladores, las siguientes llamadas no imprimen nada.
Lecciones relacionadas
- C# · Lección 23 · Intermedio · Versión: 2
- C# · Lección 24 · Intermedio · Versión: 2
- C# · Lección 25 · Intermedio · Versión: 2