CKTIS / C#
EventHandler<TEventArgs> — dogodki s tipiziranimi podatki
System.EventHandler<TEventArgs> določa delegat za obravnavo dogodkov, ki prenašajo podatke določene vrste. Poveže izdajatelja z naročniki, ne da bi bilo treba deklarirati lastno vrsto delegata.
Različica: .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> je vrsta delegata, ne sam dogodek. Opisuje obravnavo, ki vrne void in ima parametra object? sender (vir dogodka, ki je lahko null) ter TEventArgs e (podatke). Ključna beseda event uporabi to vrsto za deklaracijo dogodka; naročniki dodajo obravnavo z += in jo odstranijo z -=.
V .NET 10 deklaracija vključuje in TEventArgs in where TEventArgs : allows ref struct. Prvi zapis omogoča kontravarianco za referenčne vrste; drugi dopušča tudi argument vrste ref struct, vendar ga ne zahteva. Dedovanje od EventArgs je konvencija in ne omejitev tega API-ja v .NET 10. Starejših podpisov, prikazanih v dokumentaciji, ne obravnavajte kot deklaracijo za ta cilj prevajanja.
Za običajne podatke dogodka ustvarite razred, izpeljan iz EventArgs. Kadar dodatni podatki niso potrebni, običajno uporabite ne-generični EventHandler z EventArgs.Empty. En delegat lahko predstavlja več obravnav.
V primeru Measured?.Invoke(this, ...) posreduje izdajatelja in podatke ter preskoči klic, če ni naročnikov. Po -= druga meritev ne pokliče OnMeasured, zato je pričakovani izpis samo Value: 21.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.