WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

EventHandler<TEventArgs> — Ereignisse mit typisierten Daten

System.EventHandler<TEventArgs> definiert einen Delegaten zur Behandlung von Ereignissen, die Daten eines bestimmten Typs enthalten. Damit lässt sich ein Herausgeber mit Empfängern verbinden, ohne einen eigenen Delegatentyp deklarieren zu müssen.

Version: .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> ist ein Delegatentyp und kein Ereignis selbst. Er beschreibt einen Handler, der void zurückgibt und die Parameter object? sender (die Ereignisquelle, wobei null zulässig ist) sowie TEventArgs e (die Daten) hat. Das Schlüsselwort event verwendet diesen Typ, um ein Ereignis zu deklarieren; Empfänger registrieren Handler mit += und entfernen sie mit -=.

In .NET 10 enthält die Deklaration in TEventArgs und where TEventArgs : allows ref struct. Ersteres ermöglicht Kontravarianz für Referenztypen; Letzteres lässt auch einen Typargumenttyp ref struct zu, ohne ihn vorauszusetzen. Von EventArgs zu erben ist eine Konvention, keine Einschränkung dieser API in .NET 10. Ältere Signaturen in der Dokumentation sollten nicht als Deklaration für dieses Kompilierungsziel betrachtet werden.

Für herkömmliche Ereignisdaten erstellen Sie eine von EventArgs abgeleitete Klasse. Wenn keine zusätzlichen Daten benötigt werden, verwenden Sie normalerweise das nicht generische EventHandler mit EventArgs.Empty. Ein einzelner Delegat kann mehrere Handler repräsentieren.

Im Beispiel übergibt Measured?.Invoke(this, ...) den Herausgeber und die Daten und überspringt den Aufruf, wenn es keine Empfänger gibt. Nach -= ruft die zweite Messung OnMeasured nicht auf. Daher lautet die erwartete Ausgabe nur Value: 21.

Beispiele

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

Ergebnis

Value: 21

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen