CKTIS / C#
System.EventArgs — údaje udalosti
System.EventArgs je základná trieda používaná v štandardnom vzore udalostí .NET. Vlastná odvodená trieda prenáša údaje obslužným rutinám a EventArgs.Empty sa používa pri vyvolaní udalostí bez ďalších údajov.
Verzia: .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 je trieda knižnice .NET, nie kľúčové slovo jazyka C#. V štandardnom vzore udalostí slúži ako základná trieda pre triedy, ktoré uchovávajú údaje udalosti. Sama nedefinuje vlastnosti pre údaje aplikácie; jej verejný konštruktor EventArgs() vytvorí prázdnu inštanciu. Je dostupná v .NET 10 a v tejto verzii nie je novinkou.
Ak chcete prenášať údaje, definujte odvodenú triedu, ktorej názov sa končí na EventArgs, napríklad MessageEventArgs, a pridajte potrebné vlastnosti. Udalosť typu EventHandler<MessageEventArgs> odovzdáva obslužnej rutine dva argumenty: sender, zdroj udalosti, a e, údaje. Odvodenie z EventArgs je konvenciou tohto vzoru, nie všeobecnou požiadavkou pre každú udalosť v C#.
Ak udalosť neprenáša ďalšie údaje, použite EventHandler a pole EventArgs.Empty namiesto null alebo vytvárania ďalšieho prázdneho objektu. EventArgs opisuje údaje, zatiaľ čo delegát EventHandler opisuje signatúru obslužnej rutiny — ide o rôzne úlohy.
V príklade prenáša MessageReceived text prostredníctvom vlastnosti iba na čítanie a Completed používa EventArgs.Empty. this označuje zdroj oboch udalostí; ?.Invoke preskočí vyvolanie, ak nie sú prihlásení žiadni odberatelia. Očakávaný výstup je najprv Hello a potom Completed.
Príklady
#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);
}
}Výsledok
Hello Completed
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.