Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje