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.