CKTIS / C#
System.EventArgs — dati dell’evento
System.EventArgs è la classe base usata nel modello standard di eventi .NET. Una classe derivata personalizzata trasporta i dati ai gestori, mentre EventArgs.Empty si usa per generare eventi senza dati aggiuntivi.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
public class EventArgs
public class MessageEventArgs : EventArgs
public event EventHandler<MessageEventArgs>? MessageReceived;System.EventArgs è una classe della libreria .NET, non una parola chiave di C#. Nel modello standard di eventi è la classe base per le classi che contengono dati dell’evento. Non definisce proprietà per i dati dell’applicazione; il suo costruttore pubblico EventArgs() crea un’istanza vuota. È disponibile in .NET 10 e non è una novità di questa versione.
Per passare dati, definisci una classe derivata con un nome che termina in EventArgs, come MessageEventArgs, e aggiungi le proprietà necessarie. Un evento EventHandler<MessageEventArgs> passa al gestore due argomenti: sender, la sorgente dell’evento, ed e, i dati. Derivare da EventArgs è una convenzione di questo modello, non un requisito generale per ogni evento C#.
Se un evento non passa dati aggiuntivi, usa EventHandler e il campo EventArgs.Empty invece di null o di creare un altro oggetto vuoto. EventArgs descrive i dati, mentre il delegato EventHandler descrive la firma del gestore: sono ruoli diversi.
Nell’esempio, MessageReceived passa il testo tramite una proprietà di sola lettura e Completed usa EventArgs.Empty. this indica la sorgente di entrambi gli eventi; ?.Invoke evita la chiamata se non ci sono sottoscrittori. L’output previsto è Hello seguito da Completed.
Esempi
#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);
}
}Risultato
Hello Completed
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.