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.