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

CKTIS / C#

System.EventArgs — données d’événement

System.EventArgs est la classe de base utilisée dans le modèle d’événements standard de .NET. Une classe dérivée personnalisée transmet des données aux gestionnaires, tandis que EventArgs.Empty sert à déclencher des événements sans données supplémentaires.

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

Syntaxe

public class EventArgs
public class MessageEventArgs : EventArgs
public event EventHandler<MessageEventArgs>? MessageReceived;

System.EventArgs est une classe de la bibliothèque .NET, et non un mot-clé C#. Dans le modèle d’événements standard, elle sert de classe de base aux classes qui contiennent des données d’événement. Elle ne définit elle-même aucune propriété de données applicatives ; son constructeur public EventArgs() crée une instance vide. Elle est disponible dans .NET 10 et n’est pas nouvelle dans cette version.

Pour transmettre des données, définissez une classe dérivée dont le nom se termine par EventArgs, comme MessageEventArgs, et ajoutez les propriétés nécessaires. Un événement EventHandler<MessageEventArgs> transmet deux arguments à son gestionnaire : sender, la source de l’événement, et e, les données. Dériver de EventArgs est une convention de ce modèle, et non une exigence générale pour chaque événement C#.

Si un événement ne transmet pas de données supplémentaires, utilisez EventHandler et le champ EventArgs.Empty plutôt que null ou la création d’un autre objet vide. EventArgs décrit les données, tandis que le délégué EventHandler décrit la signature du gestionnaire — ce sont deux rôles différents.

Dans l’exemple, MessageReceived transmet du texte au moyen d’une propriété en lecture seule, et Completed utilise EventArgs.Empty. this désigne la source des deux événements ; ?.Invoke ignore l’appel s’il n’y a aucun abonné. La sortie attendue est Hello, puis Completed.

Exemples

#nullable enable
using System;

var source = new MessageSource();
source.MessageReceived += (sender, e) => Console.WriteLine(e.Message);
source.Completed += (sender, e) => Console.WriteLine("Completed");
source.Run();

public sealed class MessageEventArgs : EventArgs
{
    public MessageEventArgs(string message) => Message = message;
    public string Message { get; }
}

public sealed class MessageSource
{
    public event EventHandler<MessageEventArgs>? MessageReceived;
    public event EventHandler? Completed;

    public void Run()
    {
        MessageReceived?.Invoke(this, new MessageEventArgs("Hello"));
        Completed?.Invoke(this, EventArgs.Empty);
    }
}

Résultat

Hello
Completed

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