CKTIS / C#
System.EventArgs — dane zdarzenia
System.EventArgs to klasa bazowa używana w standardowym wzorcu zdarzeń .NET. Własna klasa pochodna przenosi dane do procedur obsługi, a EventArgs.Empty służy do zgłaszania zdarzeń bez dodatkowych danych.
Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Składnia
public class EventArgs
public class MessageEventArgs : EventArgs
public event EventHandler<MessageEventArgs>? MessageReceived;System.EventArgs jest klasą biblioteki .NET, a nie słowem kluczowym C#. W standardowym wzorcu zdarzeń stanowi bazę dla klas przechowujących dane zdarzenia. Sama nie definiuje właściwości z danymi aplikacji; jej publiczny konstruktor EventArgs() tworzy pustą instancję. Jest dostępna w .NET 10 i nie jest nowością tej wersji.
Aby przekazać dane, zdefiniuj klasę pochodną z nazwą zakończoną na EventArgs, np. MessageEventArgs, i dodaj potrzebne właściwości. Zdarzenie EventHandler<MessageEventArgs> przekazuje procedurze obsługi dwa argumenty: sender, czyli źródło zdarzenia, oraz e, czyli dane. Dziedziczenie po EventArgs jest konwencją tego wzorca, a nie ogólnym wymaganiem dla każdego zdarzenia C#.
Jeżeli zdarzenie nie przekazuje dodatkowych danych, użyj EventHandler i pola EventArgs.Empty zamiast null lub tworzenia kolejnego pustego obiektu. EventArgs opisuje dane, natomiast delegat EventHandler opisuje sygnaturę procedury obsługi — to różne role.
W przykładzie MessageReceived przekazuje tekst przez właściwość tylko do odczytu, a Completed używa EventArgs.Empty. this wskazuje źródło obu zdarzeń; ?.Invoke pomija wywołanie, gdy nie ma subskrybentów. Oczekiwane wyjście to kolejno Hello i Completed.
Przykłady
#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);
}
}Wynik
Hello Completed
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.