CKTIS / C#
System.EventArgs — gebeurtenisgegevens
System.EventArgs is de basisklasse in het standaard .NET-gebeurtenispatroon. Een zelfgemaakte afgeleide klasse geeft gegevens door aan handlers; EventArgs.Empty wordt gebruikt voor gebeurtenissen zonder extra gegevens.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
public class EventArgs
public class MessageEventArgs : EventArgs
public event EventHandler<MessageEventArgs>? MessageReceived;System.EventArgs is een klasse uit de .NET-bibliotheek, geen C#-sleutelwoord. In het standaard gebeurtenispatroon is dit de basisklasse voor klassen die gebeurtenisgegevens bevatten. De klasse definieert zelf geen eigenschappen voor toepassingsgegevens; de openbare constructor EventArgs() maakt een lege instantie. De klasse is beschikbaar in .NET 10 en is niet nieuw in die versie.
Definieer voor het doorgeven van gegevens een afgeleide klasse waarvan de naam eindigt op EventArgs, zoals MessageEventArgs, en voeg de benodigde eigenschappen toe. Een gebeurtenis van het type EventHandler<MessageEventArgs> geeft de handler twee argumenten: sender, de bron van de gebeurtenis, en e, de gegevens. Overerven van EventArgs is een conventie van dit patroon, geen algemene vereiste voor elke C#-gebeurtenis.
Als een gebeurtenis geen extra gegevens doorgeeft, gebruik dan EventHandler en het veld EventArgs.Empty in plaats van null of een nieuw leeg object. EventArgs beschrijft de gegevens, terwijl de delegate EventHandler de handtekening van de handler beschrijft — dat zijn verschillende rollen.
In het voorbeeld geeft MessageReceived tekst door via een alleen-lezen eigenschap en gebruikt Completed EventArgs.Empty. this duidt de bron van beide gebeurtenissen aan; ?.Invoke slaat de aanroep over als er geen abonnees zijn. De verwachte uitvoer is eerst Hello en daarna Completed.
Voorbeelden
#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);
}
}Resultaat
Hello Completed
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.