CKTIS / C#
System.EventHandler<TEventArgs> a System.EventArgs
Vyber správny delegát pre udalosť s údajmi alebo bez nich a odpoj obslužné metódy, keď ich už nepotrebuješ.
Verzia: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
// .NET 8 delegate signatures in namespace System (already provided by .NET):
public delegate void EventHandler<TEventArgs>(object? sender, TEventArgs e);
public delegate void EventHandler(object? sender, EventArgs e);
// In a publisher class, with using System; and a custom MessageEventArgs : EventArgs:
public event EventHandler<MessageEventArgs>? MessagePublished;
public event EventHandler? Flushed;
// Inside an instance method of that publisher:
MessagePublished?.Invoke(this, new MessageEventArgs("Build complete"));
Flushed?.Invoke(this, EventArgs.Empty);System.EventHandler<TEventArgs> je typ delegáta na deklarovanie udalosti, ktorá odovzdáva údaje. Obslužná metóda vracia void a prijíma object? sender, zvyčajne objekt, ktorý udalosť vyvoláva (môže to byť null), a TEventArgs e. System.EventArgs je základná trieda pre údaje udalosti, nie delegát. V C# 12 na .NET 8 delegát nevyžaduje, aby TEventArgs dedil z EventArgs, ale pri vlastných triedach pre údaje udalostí je to bežná konvencia .NET.
V agregátore oznámení deklaruj MessagePublished pomocou EventHandler<MessageEventArgs>. Trieda MessageEventArgs : EventArgs sprístupňuje vlastnosť Message iba na čítanie, takže obslužná metóda môže čítať e.Message bez pretypovania. Pre Flushed použi samostatný negenerický typ System.EventHandler: druhý parameter má stále typ EventArgs a vydavateľ odovzdá EventArgs.Empty, zdieľanú inštanciu bez ďalších údajov, namiesto null.
Vonkajší kód sa prihlasuje pomocou += a odhlasuje pomocou -=, ale udalosť nemôže priamo vyvolať. Trieda, ktorá udalosť deklaruje, ju vyvolá pomocou ?.Invoke(this, e), ktoré preskočí volanie, ak nie sú prihlásení žiadni odberatelia. Bežné volanie delegáta je synchrónne. Ak obslužná metóda vyvolá výnimku, ktorú nezachytí, výnimka sa prenesie k volajúcemu a ďalšie metódy v zozname volaní sa nevykonajú.
Pri prihlásení aj odhlásení použi tú istú metódu. Pri lambda výraze si ulož delegát použitý pri prihlásení. Odhlás sa, keď už oznámenia nepotrebuješ, najmä ak vydavateľ žije dlhšie než odberateľ: delegát vydavateľa môže udržiavať objekt odberateľa nažive.
Príklady
#nullable enable
using System;
var hub = new NotificationHub();
hub.MessagePublished += OnMessagePublished;
hub.Flushed += OnFlushed;
hub.Publish("Build complete");
hub.Flush();
hub.MessagePublished -= OnMessagePublished;
hub.Flushed -= OnFlushed;
hub.Publish("Not printed");
hub.Flush();
static void OnMessagePublished(object? sender, MessageEventArgs e)
=> Console.WriteLine(e.Message);
static void OnFlushed(object? sender, EventArgs e)
=> Console.WriteLine("Flushed");
sealed class MessageEventArgs : EventArgs
{
public MessageEventArgs(string message) => Message = message;
public string Message { get; }
}
sealed class NotificationHub
{
public event EventHandler<MessageEventArgs>? MessagePublished;
public event EventHandler? Flushed;
public void Publish(string message)
=> MessagePublished?.Invoke(this, new MessageEventArgs(message));
public void Flush()
=> Flushed?.Invoke(this, EventArgs.Empty);
}Výsledok
Build complete Flushed
`NotificationHub` poskytuje dve nezávislé udalosti. Prvé volania `Publish` a `Flush` vypíšu `Build complete` a `Flushed` v tomto poradí. Po odpojení oboch obslužných metód ďalšie volania nič nevypíšu.
Súvisiace lekcie
- C# · Lekcia 23 · Stredne pokročilá · Verzia: 2
- C# · Lekcia 24 · Stredne pokročilá · Verzia: 2
- C# · Lekcia 25 · Stredne pokročilá · Verzia: 2