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.