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

CKTIS / C#

EventHandler<TEventArgs> — събития с типизирани данни

System.EventHandler<TEventArgs> дефинира делегат за обработване на събития, които предават данни от определен тип. Свързва издател с абонати, без да е необходимо да се декларира собствен тип делегат.

Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Синтаксис

public delegate void EventHandler<in TEventArgs>(object? sender, TEventArgs e)
    where TEventArgs : allows ref struct;

System.EventHandler<TEventArgs> е тип делегат, а не самото събитие. Той описва обработчик, който връща void и има параметри object? sender (източника на събитието, който може да бъде null) и TEventArgs e (данните). Ключовата дума event използва този тип за деклариране на събитие; абонатите добавят обработчици с += и ги премахват с -=.

В .NET 10 декларацията включва in TEventArgs и where TEventArgs : allows ref struct. Първото позволява контравариантност за референтни типове; второто допуска и аргумент от тип ref struct, без да го изисква. Наследяването от EventArgs е конвенция, а не ограничение на този API в .NET 10. По-старите сигнатури, показани в документацията, не бива да се приемат за декларацията за тази цел на компилация.

За обичайни данни на събитие създайте клас, производен от EventArgs. Когато не са нужни допълнителни данни, обикновено използвайте негенеричния EventHandler с EventArgs.Empty. Един делегат може да представлява няколко обработчика.

В примера Measured?.Invoke(this, ...) подава издателя и данните и пропуска извикването, ако няма абонати. След -=, второто измерване не извиква OnMeasured, затова очакваният резултат е само Value: 21.

Примери

#nullable enable
using System;

var sensor = new Sensor();
sensor.Measured += OnMeasured;
sensor.Measure(21);
sensor.Measured -= OnMeasured;
sensor.Measure(22);

static void OnMeasured(object? sender, MeasurementEventArgs e)
{
    Console.WriteLine($"Value: {e.Value}");
}

sealed class MeasurementEventArgs : EventArgs
{
    public MeasurementEventArgs(int value) => Value = value;
    public int Value { get; }
}

sealed class Sensor
{
    public event EventHandler<MeasurementEventArgs>? Measured;

    public void Measure(int value)
    {
        Measured?.Invoke(this, new MeasurementEventArgs(value));
    }
}

Резултат

Value: 21

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

Източници