База знанияИзпитен център
BGБългарски
Избери език13

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

Източници