CKTIS / C#
EventHandler<TEventArgs> — udalosti s typovanými údajmi
System.EventHandler<TEventArgs> definuje delegáta na obsluhu udalostí, ktoré prenášajú údaje určeného typu. Prepája vydavateľa s odberateľmi bez potreby deklarovať vlastný typ delegáta.
Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public delegate void EventHandler<in TEventArgs>(object? sender, TEventArgs e)
where TEventArgs : allows ref struct;System.EventHandler<TEventArgs> je typ delegáta, nie samotná udalosť. Opisuje obslužnú metódu, ktorá vracia void a má parametre object? sender (zdroj udalosti, ktorý môže byť null) a TEventArgs e (údaje). Kľúčové slovo event používa tento typ na deklarovanie udalosti; odberatelia pridávajú obslužné metódy pomocou += a odoberajú ich pomocou -=.
V .NET 10 deklarácia obsahuje in TEventArgs a where TEventArgs : allows ref struct. Prvý zápis umožňuje kontravarianciu pre referenčné typy; druhý povoľuje aj argument typu ref struct, ale nevyžaduje ho. Dedenie z EventArgs je konvencia, nie obmedzenie tohto API v .NET 10. Staršie signatúry uvedené v dokumentácii nepovažujte za deklaráciu pre tento cieľ kompilácie.
Pre bežné údaje udalosti vytvorte triedu odvodenú od EventArgs. Ak nie sú potrebné ďalšie údaje, zvyčajne použite negenerický EventHandler s EventArgs.Empty. Jeden delegát môže zastupovať viacero obslužných metód.
V príklade Measured?.Invoke(this, ...) odovzdá vydavateľa a údaje a pri absencii odberateľov volanie preskočí. Po -= druhé meranie nezavolá OnMeasured, takže očakávaný výstup je iba Value: 21.
Príklady
#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));
}
}Výsledok
Value: 21
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.