Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

EventHandler<TEventArgs> — zdarzenia z typowanymi danymi

System.EventHandler<TEventArgs> definiuje delegat obsługi zdarzeń przekazujących dane określonego typu. Pozwala połączyć wydawcę z odbiorcami bez deklarowania własnego typu delegata.

Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Składnia

public delegate void EventHandler<in TEventArgs>(object? sender, TEventArgs e)
    where TEventArgs : allows ref struct;

System.EventHandler<TEventArgs> jest typem delegata, a nie samym zdarzeniem. Określa procedurę zwracającą void, z parametrami object? sender (źródło zdarzenia, dopuszczalne null) oraz TEventArgs e (dane). Słowo kluczowe event wykorzystuje ten typ do zadeklarowania zdarzenia; odbiorcy rejestrują procedury przez += i usuwają je przez -=.

W .NET 10 deklaracja zawiera in TEventArgs oraz where TEventArgs : allows ref struct. Pierwszy zapis oznacza kontrawariancję dla typów referencyjnych; drugi dopuszcza również argument typu ref struct, ale go nie wymaga. Dziedziczenie po EventArgs jest konwencją, a nie ograniczeniem tego API w .NET 10. Starszych sygnatur widocznych w dokumentacji nie należy traktować jako deklaracji dla tego celu kompilacji.

Dla typowych danych zdarzenia utwórz klasę dziedziczącą po EventArgs. Gdy nie przekazujesz dodatkowych danych, zwykle użyj niegenerycznego EventHandler i EventArgs.Empty. Jeden delegat może reprezentować wiele procedur obsługi.

W przykładzie Measured?.Invoke(this, ...) przekazuje wydawcę i dane, a przy braku subskrybentów pomija wywołanie. Po -= drugi pomiar nie uruchamia OnMeasured, dlatego oczekiwany wynik to tylko Value: 21.

Przykłady

#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));
    }
}

Wynik

Value: 21

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła