Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes