CKTIS / C#
System.EventArgs — data události
System.EventArgs je základní třída používaná ve standardním vzoru událostí .NET. Vlastní odvozená třída předává obslužným rutinám data a EventArgs.Empty se používá při vyvolání událostí bez dalších dat.
Verze: .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 je třída knihovny .NET, nikoli klíčové slovo jazyka C#. Ve standardním vzoru událostí slouží jako základní třída pro třídy, které uchovávají data události. Sama nedefinuje vlastnosti pro data aplikace; její veřejný konstruktor EventArgs() vytvoří prázdnou instanci. Je dostupná v .NET 10 a v této verzi není novinkou.
Chcete-li předávat data, definujte odvozenou třídu, jejíž název končí na EventArgs, například MessageEventArgs, a přidejte potřebné vlastnosti. Událost typu EventHandler<MessageEventArgs> předává obslužné rutině dva argumenty: sender, zdroj události, a e, data. Odvození z EventArgs je konvencí tohoto vzoru, nikoli obecným požadavkem pro každou událost v C#.
Pokud událost nepředává žádná další data, použijte EventHandler a pole EventArgs.Empty místo null nebo vytváření dalšího prázdného objektu. EventArgs popisuje data, zatímco delegát EventHandler popisuje signaturu obslužné rutiny — jde o různé role.
V příkladu předává MessageReceived text prostřednictvím vlastnosti pouze pro čtení a Completed používá EventArgs.Empty. this označuje zdroj obou událostí; ?.Invoke přeskočí vyvolání, pokud nejsou přihlášeni žádní odběratelé. Očekávaný výstup je nejprve Hello a poté Completed.
Pří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ýsledek
Hello Completed
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.