asynceventhandler 是开发者自定义的泛型委托类型，返回 task 以支持 await，需配合手动触发逻辑逐个 await 订阅者并妥善处理异常、空引用和执行顺序，不可用 async void 替代标准 eventhandler。
AsyncEventHandler 是什么，它不能直接替代 EventHandler
别被名字骗了——AsyncEventHandler 不是 .NET 内置类型，也不是语言关键字。它是开发者为支持 async 方法作为事件处理器而手动设计的委托类型。直接把 async void 方法绑给标准 EventHandler 虽然能“跑起来”，但会丢失异常传播能力、无法 await、也难以做取消或超时控制。
怎么定义和使用 AsyncEventHandler 委托
核心是声明一个返回 Task 的委托，并配合自定义事件触发逻辑：
public delegate Task AsyncEventHandler<teventargs>(object sender, TEventArgs e) where TEventArgs : EventArgs;</teventargs>
关键点：
- 必须返回
Task（或Task<t></t>），不能是void，否则无法 await - 泛型约束
where TEventArgs : EventArgs保证类型安全，避免传入任意对象 - 事件字段不能用
event EventHandler<t></t>，得用event AsyncEventHandler<t></t> - 触发时不能直接
handler(sender, e)，得用await handler(sender, e)，且要处理null和异常
触发异步事件时怎么安全地 await 所有订阅者
同步事件用 foreach 遍历委托链；异步事件必须逐个 await，否则会并行执行、丢失顺序、异常被吞掉：
public async Task RaiseAsync(MyEventArgs e)
{
var handlers = _handlers?.GetInvocationList();
if (handlers == null) return;
foreach (AsyncEventHandler<myeventargs> handler in handlers)
{
try
{
await handler(this, e);
}
catch (Exception ex)
{
// 记录日志，但不要 throw —— 否则中断后续 handler
Log.Error(ex, "Handler failed in AsyncEventHandler");
}
}
}</myeventargs>
常见错误：
- 写成
Task.WhenAll(handlers.Select(h => h(this, e)))：所有 handler 并发执行，违反事件“依次通知”的语义 - 漏掉
try/catch：一个 handler 抛异常，整个 await 链崩掉，其他 handler 永远不执行 - 没判空
_handlers：委托链为 null 时GetInvocationList()抛NullReferenceException
为什么不该用 async void 处理标准事件
有人图省事，直接写 button.Click += async (s, e) => { await DoWork(); }。这看似可行，实则埋雷：
-
async void是“火-and-忘”模式：异常无法被调用方捕获，会直接炸到SynchronizationContext或线程池，程序可能静默崩溃 - 无法 await 这个 handler 的完成，上游逻辑不知道它何时结束
- WPF/WinForms 中，
async void的 UI 线程恢复行为不稳定，容易引发跨线程访问异常 - 单元测试几乎无法覆盖：你没法等待它结束，也没法断言内部状态
真正需要异步响应的 UI 事件，应封装进命令（如 ICommand）或显式调用一个返回 Task 的方法，而不是塞进 async void 事件处理器里。
异步事件最难的不是语法，而是对“事件契约”的重新理解：它不再是即发即弃的广播，而成了可等待、可失败、需编排的协作节点。漏掉异常处理、误用并发、混淆 async void 和 async Task，这三处最容易让代码在压测或异常路径下突然失联。
