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

CKTIS / C#

System.EventArgs — datos del evento

System.EventArgs es la clase base utilizada en el patrón estándar de eventos de .NET. Una clase derivada personalizada lleva datos a los controladores, mientras que EventArgs.Empty se usa para generar eventos sin datos adicionales.

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

Sintaxis

public class EventArgs
public class MessageEventArgs : EventArgs
public event EventHandler<MessageEventArgs>? MessageReceived;

System.EventArgs es una clase de la biblioteca .NET, no una palabra clave de C#. En el patrón estándar de eventos, es la clase base de las clases que contienen datos del evento. No define por sí misma propiedades para datos de la aplicación; su constructor público EventArgs() crea una instancia vacía. Está disponible en .NET 10 y no es nueva en esta versión.

Para pasar datos, define una clase derivada cuyo nombre termine en EventArgs, como MessageEventArgs, y añade las propiedades necesarias. Un evento EventHandler<MessageEventArgs> pasa dos argumentos a su controlador: sender, el origen del evento, y e, los datos. Derivar de EventArgs es una convención de este patrón, no un requisito general para todos los eventos de C#.

Si un evento no pasa datos adicionales, usa EventHandler y el campo EventArgs.Empty en lugar de null o de crear otro objeto vacío. EventArgs describe los datos, mientras que el delegado EventHandler describe la firma del controlador: son funciones distintas.

En el ejemplo, MessageReceived pasa texto mediante una propiedad de solo lectura, y Completed usa EventArgs.Empty. this identifica el origen de ambos eventos; ?.Invoke omite la invocación si no hay suscriptores. La salida esperada es Hello seguido de Completed.

Ejemplos

#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);
    }
}

Resultado

Hello
Completed

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