Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

EventHandler<TEventArgs> — événements avec des données typées

System.EventHandler<TEventArgs> définit un délégué pour gérer les événements qui transportent des données d’un type donné. Il relie un émetteur à des abonnés sans nécessiter la déclaration d’un type de délégué personnalisé.

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

Syntaxe

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

System.EventHandler<TEventArgs> est un type délégué, et non un événement en soi. Il décrit un gestionnaire qui renvoie void, avec les paramètres object? sender (la source de l’événement, qui peut être null) et TEventArgs e (les données). Le mot-clé event utilise ce type pour déclarer un événement ; les abonnés ajoutent des gestionnaires avec += et les retirent avec -=.

Dans .NET 10, la déclaration comprend in TEventArgs et where TEventArgs : allows ref struct. Le premier permet la contravariance pour les types référence ; le second autorise également un argument de type ref struct, sans l’imposer. Hériter de EventArgs est une convention, et non une contrainte de cette API dans .NET 10. Les anciennes signatures affichées dans la documentation ne doivent pas être considérées comme la déclaration correspondant à cette cible de compilation.

Pour des données d’événement classiques, créez une classe dérivée de EventArgs. Lorsqu’aucune donnée supplémentaire n’est nécessaire, utilisez normalement le EventHandler non générique avec EventArgs.Empty. Un seul délégué peut représenter plusieurs gestionnaires.

Dans l’exemple, Measured?.Invoke(this, ...) fournit l’émetteur et les données, et ignore l’invocation en l’absence d’abonnés. Après -=, la deuxième mesure n’appelle pas OnMeasured ; la sortie attendue est donc uniquement Value: 21.

Exemples

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

Résultat

Value: 21

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources