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

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.

Fontes