Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje