CKTIS / C#
System.EventHandler<TEventArgs> e System.EventArgs
Scegli il delegato per un evento con o senza dati e rimuovi i gestori quando non servono più.
Versione: C# 12 and .NET 8; later runtimes may add compatible features
Sintassi
// .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> è il tipo delegato usato per dichiarare un evento che trasporta dati. Un gestore restituisce void e riceve object? sender, di solito l’oggetto che genera l’evento (può essere null), e TEventArgs e. System.EventArgs è una classe base per i dati dell’evento, non un delegato. In C# 12 con .NET 8, il delegato non richiede che TEventArgs derivi da EventArgs, ma questa è la convenzione di .NET per le classi di dati personalizzate.
In un aggregatore di notifiche, dichiara MessagePublished con EventHandler<MessageEventArgs>. La classe MessageEventArgs : EventArgs espone la proprietà di sola lettura Message, quindi un gestore può leggere e.Message senza cast. Per Flushed, usa il tipo distinto non generico System.EventHandler: il secondo parametro resta di tipo EventArgs e l’oggetto che pubblica l’evento passa EventArgs.Empty, un’istanza condivisa priva di dati aggiuntivi, anziché null.
Il codice esterno aggiunge un gestore con += e lo rimuove con -=, ma non può generare direttamente l’evento. La classe che dichiara l’evento lo genera con ?.Invoke(this, e), che salta la chiamata se non ci sono sottoscrittori. Una normale chiamata al delegato è sincrona. Se un gestore genera un’eccezione che non intercetta, questa si propaga al chiamante e i gestori successivi nell’elenco non vengono eseguiti.
Usa lo stesso metodo per la sottoscrizione e per la rimozione. Per una lambda, conserva il delegato usato per la sottoscrizione. Rimuovi la sottoscrizione quando non ti servono più le notifiche, soprattutto se l’oggetto che pubblica l’evento vive più a lungo del sottoscrittore: il suo delegato può mantenere in vita il sottoscrittore.
Esempi
#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);
}Risultato
Build complete Flushed
`NotificationHub` espone due eventi indipendenti. Le prime chiamate a `Publish` e `Flush` stampano rispettivamente `Build complete` e `Flushed`. Dopo la rimozione di entrambi i gestori, le chiamate successive non stampano nulla.
Lezioni correlate
- C# · Lezione 23 · Intermedio · Versione: 2
- C# · Lezione 24 · Intermedio · Versione: 2
- C# · Lezione 25 · Intermedio · Versione: 2