Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri