CKTIS / C#
System.EventArgs — dados do evento
System.EventArgs é a classe base usada no padrão de eventos padrão do .NET. Uma classe derivada personalizada transporta dados para os manipuladores, enquanto EventArgs.Empty é usado para emitir eventos sem dados adicionais.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
public class EventArgs
public class MessageEventArgs : EventArgs
public event EventHandler<MessageEventArgs>? MessageReceived;System.EventArgs é uma classe da biblioteca .NET, não uma palavra-chave de C#. No padrão de eventos padrão, é a classe base das classes que contêm dados do evento. Não define propriedades para dados da aplicação; o seu construtor público EventArgs() cria uma instância vazia. Está disponível no .NET 10 e não é uma novidade desta versão.
Para transmitir dados, defina uma classe derivada cujo nome termine em EventArgs, como MessageEventArgs, e adicione as propriedades necessárias. Um evento EventHandler<MessageEventArgs> passa dois argumentos ao seu manipulador: sender, a origem do evento, e e, os dados. Derivar de EventArgs é uma convenção deste padrão, não um requisito geral para todos os eventos C#.
Se um evento não transmitir dados adicionais, use EventHandler e o campo EventArgs.Empty em vez de null ou de criar outro objeto vazio. EventArgs descreve os dados, enquanto o delegado EventHandler descreve a assinatura do manipulador — são funções diferentes.
No exemplo, MessageReceived transmite texto através de uma propriedade só de leitura, e Completed usa EventArgs.Empty. this identifica a origem dos dois eventos; ?.Invoke omite a chamada quando não há subscritores. O resultado esperado é Hello, seguido de Completed.
Exemplos
#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
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.