Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C#

System.EventArgs — údaje udalosti

System.EventArgs je základná trieda používaná v štandardnom vzore udalostí .NET. Vlastná odvodená trieda prenáša údaje obslužným rutinám a EventArgs.Empty sa používa pri vyvolaní udalostí bez ďalších údajov.

Verzia: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntax

public class EventArgs
public class MessageEventArgs : EventArgs
public event EventHandler<MessageEventArgs>? MessageReceived;

System.EventArgs je trieda knižnice .NET, nie kľúčové slovo jazyka C#. V štandardnom vzore udalostí slúži ako základná trieda pre triedy, ktoré uchovávajú údaje udalosti. Sama nedefinuje vlastnosti pre údaje aplikácie; jej verejný konštruktor EventArgs() vytvorí prázdnu inštanciu. Je dostupná v .NET 10 a v tejto verzii nie je novinkou.

Ak chcete prenášať údaje, definujte odvodenú triedu, ktorej názov sa končí na EventArgs, napríklad MessageEventArgs, a pridajte potrebné vlastnosti. Udalosť typu EventHandler<MessageEventArgs> odovzdáva obslužnej rutine dva argumenty: sender, zdroj udalosti, a e, údaje. Odvodenie z EventArgs je konvenciou tohto vzoru, nie všeobecnou požiadavkou pre každú udalosť v C#.

Ak udalosť neprenáša ďalšie údaje, použite EventHandler a pole EventArgs.Empty namiesto null alebo vytvárania ďalšieho prázdneho objektu. EventArgs opisuje údaje, zatiaľ čo delegát EventHandler opisuje signatúru obslužnej rutiny — ide o rôzne úlohy.

V príklade prenáša MessageReceived text prostredníctvom vlastnosti iba na čítanie a Completed používa EventArgs.Empty. this označuje zdroj oboch udalostí; ?.Invoke preskočí vyvolanie, ak nie sú prihlásení žiadni odberatelia. Očakávaný výstup je najprv Hello a potom Completed.

Príklady

#nullable enable
using System;

var source = new MessageSource();
source.MessageReceived += (sender, e) => Console.WriteLine(e.Message);
source.Completed += (sender, e) => Console.WriteLine("Completed");
source.Run();

public sealed class MessageEventArgs : EventArgs
{
    public MessageEventArgs(string message) => Message = message;
    public string Message { get; }
}

public sealed class MessageSource
{
    public event EventHandler<MessageEventArgs>? MessageReceived;
    public event EventHandler? Completed;

    public void Run()
    {
        MessageReceived?.Invoke(this, new MessageEventArgs("Hello"));
        Completed?.Invoke(this, EventArgs.Empty);
    }
}

Výsledok

Hello
Completed

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje