EventArgs Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt die Basisklasse für Klassen dar, die Ereignisdaten enthalten, und stellt einen Wert bereit, der für Ereignisse verwendet werden kann, die keine Ereignisdaten enthalten.
public ref class EventArgspublic class EventArgs[System.Serializable]
public class EventArgs[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class EventArgstype EventArgs = class[<System.Serializable>]
type EventArgs = class[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type EventArgs = classPublic Class EventArgs- Vererbung
-
EventArgs
- Abgeleitet
- Attribute
Beispiele
Das folgende Beispiel zeigt eine benutzerdefinierte Ereignisdatenklasse mit dem Namen ThresholdReachedEventArgs , die von der EventArgs Klasse abgeleitet wird. Eine Instanz der Ereignisdatenklasse wird an den Ereignishandler für das ThresholdReached Ereignis übergeben.
using System;
namespace ConsoleApplication3
{
public class Program3
{
public static void Main()
{
Counter c = new(new Random().Next(10));
c.ThresholdReached += c_ThresholdReached;
Console.WriteLine("press 'a' key to increase total");
while (Console.ReadKey(true).KeyChar == 'a')
{
Console.WriteLine("adding one");
c.Add(1);
}
}
static void c_ThresholdReached(object? sender, ThresholdReachedEventArgs e)
{
Console.WriteLine("The threshold of {0} was reached at {1}.", e.Threshold, e.TimeReached);
Environment.Exit(0);
}
}
class Counter
{
private readonly int _threshold;
private int _total;
public Counter(int passedThreshold)
{
_threshold = passedThreshold;
}
public void Add(int x)
{
_total += x;
if (_total >= _threshold)
{
ThresholdReachedEventArgs args = new()
{
Threshold = _threshold,
TimeReached = DateTime.Now
};
OnThresholdReached(args);
}
}
protected virtual void OnThresholdReached(ThresholdReachedEventArgs e)
{
ThresholdReached?.Invoke(this, e);
}
public event EventHandler<ThresholdReachedEventArgs>? ThresholdReached;
}
public class ThresholdReachedEventArgs : EventArgs
{
public int Threshold { get; set; }
public DateTime TimeReached { get; set; }
}
}
open System
type ThresholdReachedEventArgs(threshold, timeReached) =
inherit EventArgs()
member _.Threshold = threshold
member _.TimeReached = timeReached
type Counter(threshold) =
let mutable total = 0
let thresholdReached = Event<_>()
member this.Add(x) =
total <- total + x
if total >= threshold then
let args = ThresholdReachedEventArgs(threshold, DateTime.Now)
thresholdReached.Trigger(this, args)
[<CLIEvent>]
member _.ThresholdReached = thresholdReached.Publish
let c_ThresholdReached(sender, e: ThresholdReachedEventArgs) =
printfn $"The threshold of {e.Threshold} was reached at {e.TimeReached}."
exit 0
let c = Counter(Random().Next 10)
c.ThresholdReached.Add c_ThresholdReached
printfn "press 'a' key to increase total"
while Console.ReadKey(true).KeyChar = 'a' do
printfn "adding one"
c.Add 1
Module Module1
Sub Main()
Dim c As Counter = New Counter(New Random().Next(10))
AddHandler c.ThresholdReached, AddressOf c_ThresholdReached
Console.WriteLine("press 'a' key to increase total")
While Console.ReadKey(True).KeyChar = "a"
Console.WriteLine("adding one")
c.Add(1)
End While
End Sub
Sub c_ThresholdReached(sender As Object, e As ThresholdReachedEventArgs)
Console.WriteLine("The threshold of {0} was reached at {1}.", e.Threshold, e.TimeReached)
Environment.Exit(0)
End Sub
End Module
Class Counter
Private threshold As Integer
Private total As Integer
Public Sub New(passedThreshold As Integer)
threshold = passedThreshold
End Sub
Public Sub Add(x As Integer)
total = total + x
If (total >= threshold) Then
Dim args As ThresholdReachedEventArgs = New ThresholdReachedEventArgs()
args.Threshold = threshold
args.TimeReached = DateTime.Now
OnThresholdReached(args)
End If
End Sub
Protected Overridable Sub OnThresholdReached(e As ThresholdReachedEventArgs)
RaiseEvent ThresholdReached(Me, e)
End Sub
Public Event ThresholdReached As EventHandler(Of ThresholdReachedEventArgs)
End Class
Class ThresholdReachedEventArgs
Inherits EventArgs
Public Property Threshold As Integer
Public Property TimeReached As DateTime
End Class
Hinweise
Diese Klasse dient als Basisklasse für alle Klassen, die Ereignisdaten darstellen. Die Klasse wird beispielsweise System.AssemblyLoadEventArgs von den Assemblyladeereignissen abgeleitet EventArgs und verwendet, um die Daten für Assemblyladeereignisse aufzubewahren. Um eine benutzerdefinierte Ereignisdatenklasse zu erstellen, erstellen Sie eine Klasse, die von der EventArgs Klasse abgeleitet wird, und stellen Sie die Eigenschaften bereit, um die erforderlichen Daten zu speichern. Der Name der benutzerdefinierten Ereignisdatenklasse sollte mit EventArgs.
Verwenden Sie das Empty Feld, um ein Objekt zu übergeben, das keine Daten enthält.
Weitere Informationen zu Ereignissen finden Sie im Artikel zum Behandeln und Auslösen von Ereignissen .
Konstruktoren
| Name | Beschreibung |
|---|---|
| EventArgs() |
Initialisiert eine neue Instanz der EventArgs-Klasse. |
Felder
| Name | Beschreibung |
|---|---|
| Empty |
Stellt einen Wert bereit, der für Ereignisse verwendet werden kann, die keine Ereignisdaten enthalten. |
Methoden
| Name | Beschreibung |
|---|---|
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Dient als die Standard-Hashfunktion (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
