C# EventHandler 委托和EventHandler＜TEventArgs＞委托

EventHandler 委托

定义

命名空间:

System

程序集:

System.Runtime.dll

表示将用于处理不具有事件数据的事件的方法。

C#复制

public delegate void EventHandler(object? sender, EventArgs e);

参数

sender

Object

事件源。

EventArgs

不包含事件数据的对象。

EventHandler<TEventArgs> 委托

定义

命名空间:

System

程序集:

System.Runtime.dll

表示当事件提供数据时将处理该事件的方法。

C#复制

public delegate void EventHandler<TEventArgs>(object? sender, TEventArgs e);

类型参数

TEventArgs

事件生成的事件数据的类型。

参数

sender

Object

事件源。

TEventArgs

包含事件数据的对象。

using System;namespace _24EventHandler委托
{class Program{static void Main(string[] args){Counter c = new Counter(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 int threshold;private int total;public Counter(int passedThreshold){threshold = passedThreshold;}public void Add(int x){total += x;if (total >= threshold){ThresholdReachedEventArgs args = new ThresholdReachedEventArgs();args.Threshold = threshold;args.TimeReached = DateTime.Now;OnThresholdReached(args);}}protected virtual void OnThresholdReached(ThresholdReachedEventArgs e){EventHandler<ThresholdReachedEventArgs> handler = ThresholdReached;if (handler != null){handler?.Invoke(this, e);}}public event EventHandler<ThresholdReachedEventArgs> ThresholdReached;}public class ThresholdReachedEventArgs : EventArgs{public int Threshold { get; set; }public DateTime TimeReached { get; set; }}
}

注解

事件模型中的事件.NET Framework基于事件委托，该委托将事件连接到其处理程序。若要引发事件，需要两个元素：

一个委托，它标识提供对事件的响应的方法。
（可选）保存事件数据的类（如果事件提供数据）。

委托是定义签名的类型，即方法的返回值类型和参数列表类型。可以使用委托类型来声明一个变量，该变量可以引用与委托签名相同的任何方法。

事件处理程序委托的标准签名定义不返回值的方法。此方法的第一个参数的类型为，引用 Object 引发事件的实例。其第二个参数派生自类型 EventArgs 并保存事件数据。如果事件不生成事件数据，则第二个参数只是字段 EventArgs.Empty 的值。否则，第二个参数是从派生的类型，它提供保存事件数据所需的任何 EventArgs 字段或属性。

委托 EventHandler 是一个预定义的委托，专门表示不生成数据的事件的事件处理程序方法。如果事件确实生成数据，则必须使用泛型委托 EventHandler<TEventArgs> 类。

若要将事件与将处理事件的方法关联，请向事件添加委托的实例。除非移除了该委托，否则每当发生该事件时就会调用事件处理程序。

EventHandler

EventHandler 委托 (System) | Microsoft Docs