Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C#

System.EventArgs — data události

System.EventArgs je základní třída používaná ve standardním vzoru událostí .NET. Vlastní odvozená třída předává obslužným rutinám data a EventArgs.Empty se používá při vyvolání událostí bez dalších dat.

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

Syntaxe

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

System.EventArgs je třída knihovny .NET, nikoli klíčové slovo jazyka C#. Ve standardním vzoru událostí slouží jako základní třída pro třídy, které uchovávají data události. Sama nedefinuje vlastnosti pro data aplikace; její veřejný konstruktor EventArgs() vytvoří prázdnou instanci. Je dostupná v .NET 10 a v této verzi není novinkou.

Chcete-li předávat data, definujte odvozenou třídu, jejíž název končí na EventArgs, například MessageEventArgs, a přidejte potřebné vlastnosti. Událost typu EventHandler<MessageEventArgs> předává obslužné rutině dva argumenty: sender, zdroj události, a e, data. Odvození z EventArgs je konvencí tohoto vzoru, nikoli obecným požadavkem pro každou událost v C#.

Pokud událost nepředává žádná další data, použijte EventHandler a pole EventArgs.Empty místo null nebo vytváření dalšího prázdného objektu. EventArgs popisuje data, zatímco delegát EventHandler popisuje signaturu obslužné rutiny — jde o různé role.

V příkladu předává MessageReceived text prostřednictvím vlastnosti pouze pro čtení a Completed používá EventArgs.Empty. this označuje zdroj obou událostí; ?.Invoke přeskočí vyvolání, pokud nejsou přihlášeni žádní odběratelé. Očekávaný výstup je nejprve Hello a poté Completed.

Pří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ýsledek

Hello
Completed

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje