CKTIS / C#
System.EventHandler<TEventArgs> и System.EventArgs
Избери подходящ делегат за събитие със или без данни и премахни обработчиците, когато вече не са нужни.
Версия: C# 12 and .NET 8; later runtimes may add compatible features
Синтаксис
// .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> е типът делегат, с който се декларира събитие, пренасящо данни. Обработчикът връща void и получава object? sender, обикновено обекта, който предизвиква събитието (може да е null), и TEventArgs e. System.EventArgs е базов клас за данни на събития, а не делегат. В C# 12 върху .NET 8 делегатът не изисква TEventArgs да наследява EventArgs, но това е установената практика в .NET за собствени класове с данни за събития.
В агрегатор на известия декларирай MessagePublished с EventHandler<MessageEventArgs>. Класът MessageEventArgs : EventArgs предоставя свойството Message само за четене, така че обработчикът може да прочете e.Message без преобразуване на типа. За Flushed използвай отделния необобщен тип System.EventHandler: вторият параметър остава от тип EventArgs, а издателят подава EventArgs.Empty, споделена инстанция без допълнителни данни, вместо null.
Външният код се абонира с += и се отписва с -=, но не може директно да предизвика събитието. Класът, който декларира събитието, го предизвиква чрез ?.Invoke(this, e), което пропуска извикването, ако няма абонати. Обикновеното извикване на делегат е синхронно. Ако обработчик хвърли изключение, което не прихване, то се предава към извикващия код, а следващите обработчици в списъка не се изпълняват.
Използвай един и същ метод при абониране и отписване. Ако използваш ламбда израз, запази делегата, с който си се абонирал. Отпиши се, когато известията вече не ти трябват, особено ако издателят живее по-дълго от абоната: делегатът на издателя може да задържи обекта на абоната жив.
Примери
#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);
}Резултат
Build complete Flushed
`NotificationHub` предоставя две независими събития. Първите извиквания на `Publish` и `Flush` извеждат съответно `Build complete` и `Flushed`. След премахването на двата обработчика следващите извиквания не извеждат нищо.
Свързани уроци
- C# · Урок 23 · Средно · Версия: 2
- C# · Урок 24 · Средно · Версия: 2
- C# · Урок 25 · Средно · Версия: 2