CKTIS / C#
EventHandler<TEventArgs> — događaji s tipiziranim podacima
System.EventHandler<TEventArgs> definira delegat za obradu događaja koji prenose podatke određene vrste. Povezuje izdavača s pretplatnicima bez potrebe za deklariranjem prilagođene vrste delegata.
Verzija: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaksa
public delegate void EventHandler<in TEventArgs>(object? sender, TEventArgs e)
where TEventArgs : allows ref struct;System.EventHandler<TEventArgs> vrsta je delegata, a ne sam događaj. Opisuje rukovatelja koji vraća void i ima parametre object? sender (izvor događaja, koji može biti null) i TEventArgs e (podatke). Ključna riječ event koristi ovu vrstu za deklariranje događaja; pretplatnici dodaju rukovatelje pomoću += i uklanjaju ih pomoću -=.
U .NET 10 deklaracija sadrži in TEventArgs i where TEventArgs : allows ref struct. Prvi zapis omogućuje kontravarijantnost za referentne vrste; drugi dopušta i argument vrste ref struct, ali ga ne zahtijeva. Nasljeđivanje od EventArgs konvencija je, a ne ograničenje ovog API-ja u .NET 10. Starije potpise prikazane u dokumentaciji nemojte smatrati deklaracijom za ovaj cilj kompilacije.
Za uobičajene podatke događaja stvorite klasu izvedenu iz EventArgs. Kada dodatni podaci nisu potrebni, obično upotrijebite ne-generički EventHandler s EventArgs.Empty. Jedan delegat može predstavljati više rukovatelja.
U primjeru Measured?.Invoke(this, ...) prosljeđuje izdavača i podatke te preskače poziv ako nema pretplatnika. Nakon -=, drugo mjerenje ne poziva OnMeasured, pa je očekivani izlaz samo Value: 21.
Primjeri
#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));
}
}Rezultat
Value: 21
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.