CKTIS / C#
EventHandler<TEventArgs> — eventi con dati tipizzati
System.EventHandler<TEventArgs> definisce un delegato per gestire eventi che trasportano dati di un tipo specificato. Collega un mittente ai sottoscrittori senza richiedere la dichiarazione di un tipo delegato personalizzato.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
public delegate void EventHandler<in TEventArgs>(object? sender, TEventArgs e)
where TEventArgs : allows ref struct;System.EventHandler<TEventArgs> è un tipo delegato, non un evento in sé. Descrive un gestore che restituisce void e ha i parametri object? sender (la sorgente dell’evento, che può essere null) e TEventArgs e (i dati). La parola chiave event usa questo tipo per dichiarare un evento; i sottoscrittori aggiungono i gestori con += e li rimuovono con -=.
In .NET 10, la dichiarazione include in TEventArgs e where TEventArgs : allows ref struct. Il primo consente la controvarianza per i tipi riferimento; il secondo ammette anche un argomento di tipo ref struct, senza richiederlo. Ereditare da EventArgs è una convenzione, non un vincolo di questa API in .NET 10. Le firme precedenti mostrate nella documentazione non devono essere considerate la dichiarazione per questa destinazione di compilazione.
Per i dati evento convenzionali, crea una classe derivata da EventArgs. Quando non servono dati aggiuntivi, normalmente si usa il EventHandler non generico con EventArgs.Empty. Un singolo delegato può rappresentare più gestori.
Nell’esempio, Measured?.Invoke(this, ...) fornisce il mittente e i dati e salta l’invocazione se non ci sono sottoscrittori. Dopo -=, la seconda misurazione non chiama OnMeasured, quindi l’output previsto è solo Value: 21.
Esempi
#nullable enable
using System;
var sensor = new Sensor();
sensor.Measured += OnMeasured;
sensor.Measure(21);
sensor.Measured -= OnMeasured;
sensor.Measure(22);
static void OnMeasured(object? sender, MeasurementEventArgs e)
{
Console.WriteLine($"Value: {e.Value}");
}
sealed class MeasurementEventArgs : EventArgs
{
public MeasurementEventArgs(int value) => Value = value;
public int Value { get; }
}
sealed class Sensor
{
public event EventHandler<MeasurementEventArgs>? Measured;
public void Measure(int value)
{
Measured?.Invoke(this, new MeasurementEventArgs(value));
}
}Risultato
Value: 21
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.