CKTIS / C#
EventHandler<TEventArgs> — eventos com dados tipados
System.EventHandler<TEventArgs> define um delegado para tratar eventos que transportam dados de um tipo especificado. Liga um publicador aos subscritores sem exigir a declaração de um tipo de delegado personalizado.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
public delegate void EventHandler<in TEventArgs>(object? sender, TEventArgs e)
where TEventArgs : allows ref struct;System.EventHandler<TEventArgs> é um tipo delegado, não um evento em si. Descreve um manipulador que devolve void e tem os parâmetros object? sender (a origem do evento, podendo ser null) e TEventArgs e (os dados). A palavra-chave event utiliza este tipo para declarar um evento; os subscritores registam manipuladores com += e removem-nos com -=.
No .NET 10, a declaração inclui in TEventArgs e where TEventArgs : allows ref struct. O primeiro permite a contravariância para tipos de referência; o segundo também permite um argumento de tipo ref struct, sem o exigir. Herdar de EventArgs é uma convenção, não uma restrição desta API no .NET 10. As assinaturas mais antigas apresentadas na documentação não devem ser tratadas como a declaração para este destino de compilação.
Para dados de evento convencionais, crie uma classe derivada de EventArgs. Quando não são necessários dados adicionais, normalmente utilize o EventHandler não genérico com EventArgs.Empty. Um único delegado pode representar vários manipuladores.
No exemplo, Measured?.Invoke(this, ...) fornece o publicador e os dados e omite a invocação quando não há subscritores. Após -=, a segunda medição não chama OnMeasured, pelo que o resultado esperado é apenas Value: 21.
Exemplos
#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));
}
}Resultado
Value: 21
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.