CKTIS / C#
System.EventArgs — данни за събитието
System.EventArgs е базовият клас, използван в стандартния модел за събития на .NET. Потребителски производен клас предава данни на обработчиците, а EventArgs.Empty се използва при задействане на събития без допълнителни данни.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
public class EventArgs
public class MessageEventArgs : EventArgs
public event EventHandler<MessageEventArgs>? MessageReceived;System.EventArgs е клас от библиотеката .NET, а не ключова дума в C#. В стандартния модел за събития той е базов клас за класове, които съдържат данни за събитието. Самият той не дефинира свойства за данни на приложението; публичният му конструктор EventArgs() създава празен екземпляр. Наличен е в .NET 10 и не е новост в тази версия.
За да предавате данни, дефинирайте производен клас с име, завършващо на EventArgs, например MessageEventArgs, и добавете необходимите свойства. Събитие от тип EventHandler<MessageEventArgs> предава на обработчика два аргумента: sender — източника на събитието, и e — данните. Наследяването от EventArgs е конвенция на този модел, а не общо изискване за всяко събитие в C#.
Ако събитието не предава допълнителни данни, използвайте EventHandler и полето EventArgs.Empty, вместо null или създаването на друг празен обект. EventArgs описва данните, докато делегатът EventHandler описва сигнатурата на обработчика — това са различни роли.
В примера MessageReceived предава текст чрез свойство само за четене, а Completed използва EventArgs.Empty. this обозначава източника и на двете събития; ?.Invoke пропуска извикването, когато няма абонати. Очакваният изход е първо Hello, а след това Completed.
Примери
#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);
}
}Резултат
Hello Completed
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.