Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

System.EventArgs — podaci događaja

System.EventArgs je osnovna klasa koja se upotrebljava u standardnom obrascu događaja .NET-a. Vlastita izvedena klasa prenosi podatke obrađivačima, a EventArgs.Empty koristi se za pokretanje događaja bez dodatnih podataka.

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

Sintaksa

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

System.EventArgs klasa je biblioteke .NET, a ne ključna riječ jezika C#. U standardnom obrascu događaja služi kao osnovna klasa za klase koje sadrže podatke događaja. Sama ne definira svojstva za podatke aplikacije; njezin javni konstruktor EventArgs() stvara praznu instancu. Dostupna je u .NET 10 i nije novost te verzije.

Za prijenos podataka definirajte izvedenu klasu čije ime završava s EventArgs, primjerice MessageEventArgs, i dodajte potrebna svojstva. Događaj EventHandler<MessageEventArgs> prosljeđuje obrađivaču dva argumenta: sender, izvor događaja, i e, podatke. Izvođenje iz EventArgs konvencija je ovog obrasca, a ne opći zahtjev za svaki događaj u C#-u.

Ako događaj ne prenosi dodatne podatke, upotrijebite EventHandler i polje EventArgs.Empty umjesto null ili stvaranja drugog praznog objekta. EventArgs opisuje podatke, dok delegat EventHandler opisuje potpis obrađivača — to su različite uloge.

U primjeru MessageReceived prenosi tekst putem svojstva samo za čitanje, a Completed upotrebljava EventArgs.Empty. this označava izvor oba događaja; ?.Invoke preskače poziv ako nema pretplatnika. Očekivani je izlaz najprije Hello, a zatim Completed.

Primjeri

#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);
    }
}

Rezultat

Hello
Completed

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori