Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

System.EventHandler<TEventArgs> i System.EventArgs

Odaberi delegat za događaj s podacima ili bez njih i ukloni rukovatelje kad ti više nisu potrebni.

Verzija: 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> jest tip delegata kojim deklariraš događaj koji prenosi podatke. Rukovatelj vraća void i prima object? sender, obično objekt koji podiže događaj (može biti null), te TEventArgs e. System.EventArgs je osnovna klasa za podatke događaja, a ne delegat. U C# 12 na .NET-u 8 delegat ne zahtijeva da TEventArgs nasljeđuje EventArgs, ali to je uobičajena .NET konvencija za vlastite klase s podacima događaja.

U agregatoru obavijesti deklariraj MessagePublished pomoću EventHandler<MessageEventArgs>. Klasa MessageEventArgs : EventArgs izlaže svojstvo Message samo za čitanje pa rukovatelj može čitati e.Message bez pretvorbe tipa. Za Flushed koristi zaseban negenerički tip System.EventHandler: drugi parametar i dalje je tipa EventArgs, a izdavač umjesto null predaje EventArgs.Empty, zajedničku instancu bez dodatnih podataka.

Vanjski se kôd pretplaćuje pomoću += i otkazuje pretplatu pomoću -=, ali ne može izravno podići događaj. Klasa koja deklarira događaj podiže ga pomoću ?.Invoke(this, e), čime se preskače poziv ako nema pretplatnika. Običan poziv delegata izvršava se sinkrono. Ako rukovatelj baci iznimku koju ne uhvati, ona se prosljeđuje pozivatelju, a rukovatelji koji slijede na popisu poziva neće se izvršiti.

Za pretplatu i otkazivanje upotrijebi istu metodu. Za lambda izraz spremi delegat kojim si se pretplatio. Otkaži pretplatu kad ti obavijesti više nisu potrebne, posebno ako izdavač živi dulje od pretplatnika: delegat izdavača može održati objekt pretplatnika na životu.

Primjeri

#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` nudi dva neovisna događaja. Prvi pozivi metoda `Publish` i `Flush` ispisuju `Build complete` odnosno `Flushed`. Nakon uklanjanja oba rukovatelja sljedeći pozivi ne ispisuju ništa.

Povezane lekcije

  • C# · Lekcija 23 · Srednje · Verzija: 2
  • C# · Lekcija 24 · Srednje · Verzija: 2
  • C# · Lekcija 25 · Srednje · Verzija: 2

Izvori