CKTIS / C#
System.EventHandler<TEventArgs> a System.EventArgs
Zvol správný delegát pro událost s daty nebo bez dat a odpoj obslužné metody, jakmile je nepotřebuješ.
Verze: C# 12 and .NET 8; later runtimes may add compatible features
Syntaxe
// .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 pro deklaraci události, která předává data. Obslužná metoda vrací void a přijímá object? sender, obvykle objekt vyvolávající událost (může jít o null), a TEventArgs e. System.EventArgs je základní třída pro data události, nikoli delegát. V C# 12 na .NET 8 delegát nevyžaduje, aby TEventArgs dědil z EventArgs, ale u vlastních tříd pro data událostí je to běžná konvence .NET.
V agregátoru oznámení deklaruj MessagePublished pomocí EventHandler<MessageEventArgs>. Třída MessageEventArgs : EventArgs zpřístupňuje vlastnost Message pouze pro čtení, takže obslužná metoda může číst e.Message bez přetypování. Pro Flushed použij samostatný negenerický typ System.EventHandler: druhý parametr má stále typ EventArgs a vydavatel předává EventArgs.Empty, sdílenou instanci bez dalších dat, místo null.
Vnější kód přidává obslužnou metodu pomocí += a odebírá ji pomocí -=, ale nemůže událost přímo vyvolat. Třída, která událost deklaruje, ji vyvolá pomocí ?.Invoke(this, e), které přeskočí volání, pokud není nikdo přihlášen. Běžné volání delegáta probíhá synchronně. Pokud obslužná metoda vyvolá výjimku, kterou nezachytí, výjimka se předá volajícímu a následující metody v seznamu volání se neprovedou.
Při přihlášení i odhlášení použij stejnou metodu. U lambda výrazu si ulož delegát použitý při přihlášení. Odhlas se, jakmile oznámení nepotřebuješ, zejména pokud vydavatel žije déle než odběratel: delegát vydavatele může objekt odběratele udržovat naživu.
Pří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ýsledek
Build complete Flushed
`NotificationHub` poskytuje dvě nezávislé události. První volání `Publish` a `Flush` vypíší `Build complete`, respektive `Flushed`. Po odebrání obou obslužných metod už další volání nic nevypíší.
Související lekce
- C# · Lekce 23 · Středně pokročilá · Verze: 2
- C# · Lekce 24 · Středně pokročilá · Verze: 2
- C# · Lekce 25 · Středně pokročilá · Verze: 2