CKTIS / C#
System.EventArgs — podatki dogodka
System.EventArgs je osnovni razred, ki se uporablja v standardnem vzorcu dogodkov .NET. Lasten izpeljani razred prenaša podatke obravnavalnikom, EventArgs.Empty pa se uporablja pri proženju dogodkov brez dodatnih podatkov.
Različica: .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 je razred knjižnice .NET, ne ključna beseda jezika C#. V standardnem vzorcu dogodkov je osnovni razred za razrede, ki hranijo podatke dogodka. Sam ne določa lastnosti za podatke aplikacije; njegov javni konstruktor EventArgs() ustvari prazen primerek. Na voljo je v .NET 10 in v tej različici ni novost.
Za prenos podatkov določite izpeljani razred, katerega ime se konča z EventArgs, na primer MessageEventArgs, in dodajte potrebne lastnosti. Dogodek EventHandler<MessageEventArgs> obravnavalniku posreduje dva argumenta: sender, vir dogodka, in e, podatke. Izpeljava iz EventArgs je konvencija tega vzorca, ne splošna zahteva za vsak dogodek v C#.
Če dogodek ne prenaša dodatnih podatkov, uporabite EventHandler in polje EventArgs.Empty namesto null ali ustvarjanja dodatnega praznega predmeta. EventArgs opisuje podatke, medtem ko delegat EventHandler opisuje podpis obravnavalnika — to sta različni vlogi.
V primeru MessageReceived posreduje besedilo prek lastnosti samo za branje, Completed pa uporablja EventArgs.Empty. this označuje vir obeh dogodkov; ?.Invoke preskoči klic, če ni naročnikov. Pričakovani izhod je najprej Hello, nato Completed.
Primeri
#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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.