CKTIS / C#
EventHandler<TEventArgs> — události s typovanými daty
System.EventHandler<TEventArgs> definuje delegáta pro obsluhu událostí, které předávají data určitého typu. Propojí vydavatele s odběrateli, aniž by bylo nutné deklarovat vlastní typ delegáta.
Verze: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
public delegate void EventHandler<in TEventArgs>(object? sender, TEventArgs e)
where TEventArgs : allows ref struct;System.EventHandler<TEventArgs> je typ delegáta, nikoli samotná událost. Popisuje obslužnou metodu, která vrací void a má parametry object? sender (zdroj události, který může být null) a TEventArgs e (data). Klíčové slovo event tento typ používá k deklaraci události; odběratelé přidávají obslužné metody pomocí += a odebírají je pomocí -=.
V .NET 10 deklarace obsahuje in TEventArgs a where TEventArgs : allows ref struct. První zápis umožňuje kontravarianci pro referenční typy; druhý povoluje také argument typu ref struct, aniž by jej vyžadoval. Dědění z EventArgs je konvence, nikoli omezení tohoto API v .NET 10. Starší signatury uvedené v dokumentaci nepovažujte za deklaraci pro tento cíl kompilace.
Pro běžná data události vytvořte třídu odvozenou z EventArgs. Pokud nejsou potřeba žádná další data, obvykle použijte negenerický EventHandler s EventArgs.Empty. Jeden delegát může zastupovat více obslužných metod.
V příkladu Measured?.Invoke(this, ...) předá vydavatele a data a při absenci odběratelů volání přeskočí. Po -= druhé měření OnMeasured nezavolá, takže očekávaný výstup je pouze Value: 21.
Pří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ýsledek
Value: 21
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.