《深入浅出WPF》：8.3.2 自定义路由事件 事件注册类型为 EventHandler<ReportTimeEventArgs>，但.NET 事件包装器类型为 RoutedEventHandler

事件处理器的签名要和注册时的签名一致：

包装器的参数类型为基类型，事件处理器的参数类型为子类型，根据委托协变，可以把子类型参数的委托赋值给基类型参数的委托

以下是deepseek回答：

这是一个非常好的问题，它触及了 WPF 路由事件中一个关于类型兼容性和历史设计的细节。

你的观察是准确的：代码中确实存在一个看似不一致的地方。我们来分析一下为什么可以这样做，以及为什么要这样设计。

核心原因：类型兼容性与 .NET 事件协变/逆变

1. 事件注册时的类型：

   public static readonly RoutedEvent ReportTimeEvent = EventManager.RegisterRoutedEvent(
       "ReportTime", RoutingStrategy.Bubble, typeof(EventHandler<ReportTimeEventArgs>), typeof(TimeButton));
   

   这里，RegisterRoutedEvent 方法的第三个参数是 handlerType，它指定了哪个委托类型可以处理这个事件。这里使用的是 EventHandler<ReportTimeEventArgs>。这意味着事件处理程序的签名必须是 void MethodName(object sender, ReportTimeEventArgs e)。

2. .NET 事件包装器：

   public event RoutedEventHandler ReportTime
   {
       add { AddHandler(ReportTimeEvent, value); }
       remove { RemoveHandler(ReportTimeEvent, value); }
   }
   

   这里你发现，公共事件的类型是 RoutedEventHandler。RoutedEventHandler 的签名是 void MethodName(object sender, RoutedEventArgs e)。

   那么问题来了：RoutedEventHandler 类型的委托怎么能被添加到期望 EventHandler<ReportTimeEventArgs> 类型委托的事件中呢？

3. 关键的兼容性：.NET 委托的协变

   • RoutedEventHandler 的参数是 RoutedEventArgs。
   • 你的自定义参数 ReportTimeEventArgs 继承自 RoutedEventArgs。
   • 在 .NET 中，委托支持协变。这意味着一个期望接收基类参数（如 RoutedEventArgs）的委托，可以安全地引用一个接收派生类参数（如 ReportTimeEventArgs）的方法。
   • 反过来，EventHandler<ReportTimeEventArgs> 可以被视为 RoutedEventHandler 的一个“更具体”的版本。因为任何能处理 RoutedEventArgs 的方法，必然也能处理它的子类 ReportTimeEventArgs（这是“里氏替换原则”的体现）。编译器允许这种赋值。

   因此，当你写 local:TimeButton.ReportTime="ReportTimeHandler" 时，XAML 编译器和运行时知道你的 ReportTimeHandler 方法符合 EventHandler<ReportTimeEventArgs> 的签名，所以它可以安全地工作。

为什么要包装成 RoutedEventHandler 类型？

既然技术上允许，那么设计上为什么选择 RoutedEventHandler 而不是 EventHandler<ReportTimeEventArgs> 呢？这主要是出于一致性和习惯。

1. 与 WPF 内置事件保持一致：WPF 中绝大多数路由事件（如 Button.Click、Mouse.MouseDown）都使用 RoutedEventHandler 作为其公共事件的委托类型。即使它们的事件参数是更具体的类型（如 MouseButtonEventArgs 继承自 RoutedEventArgs），它们的公共事件也仍然定义为 RoutedEventHandler。你的自定义事件遵循了这一惯例，使得它看起来和用起来都像一个“标准”的 WPF 路由事件。

2. 简化 XAML 书写：在 XAML 中，当你输入 Button.Click= 时，智能感知和编译器期望的是一个 RoutedEventHandler 类型的方法。如果你的自定义事件也使用 RoutedEventHandler，那么开发者在为你的 TimeButton.ReportTime 事件指定处理程序时，会有完全一致的体验。他们不需要去记忆一个特殊的 EventHandler<ReportTimeEventArgs> 类型。

3. 历史原因：EventHandler<T> 泛型委托是在 .NET Framework 2.0 中引入的，而 WPF 的部分设计可能更早，或者为了与早期的设计模式保持一致，选择了使用非泛型的 RoutedEventHandler。这个习惯被保留了下来。

总结

• 技术上可行：因为委托协变，EventHandler<ReportTimeEventArgs> 与 RoutedEventHandler 是兼容的。ReportTimeHandler 方法的签名最终匹配的是事件注册时指定的 EventHandler<ReportTimeEventArgs>。
• 设计上合理：将公共事件包装为 RoutedEventHandler 类型，是为了与 WPF 框架中其他所有路由事件保持一致，提供统一的编程体验。

所以，这并不是一个错误，而是一个遵循 WPF 惯例的、经过深思熟虑的设计。它保证了自定义路由事件在行为和用法上与原生事件无缝集成。