KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C#

EventHandler<TEventArgs> — gebeurtenissen met getypeerde gegevens

System.EventHandler<TEventArgs> definieert een gedelegeerde voor het afhandelen van gebeurtenissen met gegevens van een bepaald type. Hiermee wordt een uitgever gekoppeld aan abonnees zonder dat een aangepast gedelegeerdetype nodig is.

Versie: .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> is een gedelegeerdetype, geen gebeurtenis op zich. Het beschrijft een handler die void retourneert, met de parameters object? sender (de bron van de gebeurtenis, waarbij null is toegestaan) en TEventArgs e (de gegevens). Het sleutelwoord event gebruikt dit type om een gebeurtenis te declareren; abonnees registreren handlers met += en verwijderen ze met -=.

In .NET 10 bevat de declaratie in TEventArgs en where TEventArgs : allows ref struct. Het eerste maakt contravariantie voor verwijzingstypen mogelijk; het tweede staat ook een typeargument ref struct toe, zonder dit te vereisen. Overerven van EventArgs is een conventie, geen beperking van deze API in .NET 10. Oudere handtekeningen in de documentatie moeten niet worden beschouwd als de declaratie voor dit compilatiedoel.

Maak voor gebruikelijke gebeurtenisgegevens een klasse die is afgeleid van EventArgs. Als er geen extra gegevens nodig zijn, gebruik dan meestal de niet-generieke EventHandler met EventArgs.Empty. Eén gedelegeerde kan meerdere handlers vertegenwoordigen.

In het voorbeeld geeft Measured?.Invoke(this, ...) de uitgever en gegevens door en wordt de aanroep overgeslagen als er geen abonnees zijn. Na -= roept de tweede meting OnMeasured niet aan, dus de verwachte uitvoer is alleen Value: 21.

Voorbeelden

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

Resultaat

Value: 21

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen