Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

EventHandler<TEventArgs> — eventos con datos tipados

System.EventHandler<TEventArgs> define un delegado para gestionar eventos que transportan datos de un tipo determinado. Conecta un emisor con sus suscriptores sin necesidad de declarar un tipo de delegado personalizado.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

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

System.EventHandler<TEventArgs> es un tipo delegado, no un evento en sí. Describe un controlador que devuelve void y tiene los parámetros object? sender (el origen del evento, que puede ser null) y TEventArgs e (los datos). La palabra clave event utiliza este tipo para declarar un evento; los suscriptores agregan controladores con += y los quitan con -=.

En .NET 10, la declaración incluye in TEventArgs y where TEventArgs : allows ref struct. El primero permite la contravarianza para tipos de referencia; el segundo también permite un argumento de tipo ref struct, sin exigirlo. Heredar de EventArgs es una convención, no una restricción de esta API en .NET 10. Las firmas antiguas que aparecen en la documentación no deben considerarse la declaración correspondiente a este destino de compilación.

Para los datos de evento habituales, crea una clase derivada de EventArgs. Cuando no se necesitan datos adicionales, normalmente se usa el EventHandler no genérico con EventArgs.Empty. Un solo delegado puede representar varios controladores.

En el ejemplo, Measured?.Invoke(this, ...) proporciona el emisor y los datos, y omite la invocación si no hay suscriptores. Después de -=, la segunda medición no llama a OnMeasured, por lo que la salida esperada es solo Value: 21.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes