CKTIS / C#
System.EventHandler<TEventArgs> in System.EventArgs
Izberi delegata za dogodek s podatki ali brez njih in odstrani obravnavalnike, ko jih ne potrebuješ več.
Različica: C# 12 and .NET 8; later runtimes may add compatible features
Sintaksa
// .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 tip delegata za deklaracijo dogodka, ki posreduje podatke. Obravnavalnik vrne void in sprejme object? sender, navadno objekt, ki sproži dogodek (lahko je null), ter TEventArgs e. System.EventArgs je osnovni razred za podatke o dogodku, ne delegat. V C# 12 na .NET 8 delegat ne zahteva, da TEventArgs deduje od EventArgs, vendar je to običajna konvencija .NET za lastne razrede s podatki o dogodkih.
V zbirniku obvestil deklariraj MessagePublished z EventHandler<MessageEventArgs>. Razred MessageEventArgs : EventArgs izpostavi lastnost Message samo za branje, zato lahko obravnavalnik prebere e.Message brez pretvorbe tipa. Za Flushed uporabi ločen negenerični tip System.EventHandler: drugi parameter je še vedno tipa EventArgs, objavitelj pa namesto null posreduje EventArgs.Empty, skupni primerek brez dodatnih podatkov.
Zunanja koda se naroči z += in odjavi z -=, dogodka pa ne more sprožiti neposredno. Razred, ki deklarira dogodek, ga sproži z ?.Invoke(this, e), ki preskoči klic, če ni naročnikov. Običajen klic delegata je sinhron. Če obravnavalnik sproži izjemo, ki je ne prestreže, se ta prenese do klicatelja, poznejši obravnavalniki s seznama klicev pa se ne izvedejo.
Za naročanje in odjavo uporabi isto metodo. Pri izrazu lambda shrani delegata, ki si ga uporabil za naročanje. Odjavi se, ko obvestil ne potrebuješ več, zlasti če objavitelj živi dlje od naročnika: objaviteljev delegat lahko ohranja objekt naročnika pri življenju.
Primeri
#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);
}Rezultat
Build complete Flushed
`NotificationHub` ponuja dva neodvisna dogodka. Prva klica metod `Publish` in `Flush` izpišeta `Build complete` in `Flushed` v tem vrstnem redu. Po odstranitvi obeh obravnavalnikov naslednja klica ne izpišeta ničesar.
Povezane lekcije
- C# · Lekcija 23 · Srednja · Različica: 2
- C# · Lekcija 24 · Srednja · Različica: 2
- C# · Lekcija 25 · Srednja · Različica: 2