База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници