WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C#

System.EventArgs — Ereignisdaten

System.EventArgs ist die Basisklasse des standardmäßigen .NET-Ereignismusters. Eine eigene abgeleitete Klasse übermittelt Daten an Ereignisbehandler; EventArgs.Empty wird verwendet, wenn ein Ereignis ohne zusätzliche Daten ausgelöst wird.

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

Syntax

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

System.EventArgs ist eine .NET-Bibliotheksklasse und kein C#-Schlüsselwort. Im standardmäßigen Ereignismuster dient sie als Basisklasse für Klassen, die Ereignisdaten enthalten. Sie selbst definiert keine Eigenschaften für Anwendungsdaten; ihr öffentlicher Konstruktor EventArgs() erstellt eine leere Instanz. Sie ist in .NET 10 verfügbar und nicht neu in dieser Version.

Um Daten zu übermitteln, definieren Sie eine abgeleitete Klasse, deren Name auf EventArgs endet, etwa MessageEventArgs, und fügen Sie die benötigten Eigenschaften hinzu. Ein Ereignis vom Typ EventHandler<MessageEventArgs> übergibt seinem Behandler zwei Argumente: sender, die Ereignisquelle, und e, die Daten. Die Ableitung von EventArgs ist eine Konvention dieses Musters, keine allgemeine Voraussetzung für jedes C#-Ereignis.

Wenn ein Ereignis keine zusätzlichen Daten übermittelt, verwenden Sie EventHandler und das Feld EventArgs.Empty, statt null oder ein weiteres leeres Objekt zu erzeugen. EventArgs beschreibt die Daten, während der Delegat EventHandler die Signatur des Behandlers beschreibt — das sind unterschiedliche Aufgaben.

Im Beispiel übermittelt MessageReceived Text über eine schreibgeschützte Eigenschaft, und Completed verwendet EventArgs.Empty. this bezeichnet die Quelle beider Ereignisse; ?.Invoke überspringt den Aufruf, wenn es keine Abonnenten gibt. Die erwartete Ausgabe lautet zuerst Hello, dann Completed.

Beispiele

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

Ergebnis

Hello
Completed

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen