事件处理器的签名要和注册时的签名一致:
包装器的参数类型为基类型,事件处理器的参数类型为子类型,根据委托协变,可以把子类型参数的委托赋值给基类型参数的委托
以下是deepseek回答:
这是一个非常好的问题,它触及了 WPF 路由事件中一个关于类型兼容性和历史设计的细节。
你的观察是准确的:代码中确实存在一个看似不一致的地方。我们来分析一下为什么可以这样做,以及为什么要这样设计。
核心原因:类型兼容性与 .NET 事件协变/逆变
-
事件注册时的类型:
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)
。 -
.NET 事件包装器:
public event RoutedEventHandler ReportTime {add { AddHandler(ReportTimeEvent, value); }remove { RemoveHandler(ReportTimeEvent, value); } }
这里你发现,公共事件的类型是
RoutedEventHandler
。RoutedEventHandler
的签名是void MethodName(object sender, RoutedEventArgs e)
。那么问题来了:
RoutedEventHandler
类型的委托怎么能被添加到期望EventHandler<ReportTimeEventArgs>
类型委托的事件中呢? -
关键的兼容性:.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>
呢?这主要是出于一致性和习惯。
-
与 WPF 内置事件保持一致:WPF 中绝大多数路由事件(如
Button.Click
、Mouse.MouseDown
)都使用RoutedEventHandler
作为其公共事件的委托类型。即使它们的事件参数是更具体的类型(如MouseButtonEventArgs
继承自RoutedEventArgs
),它们的公共事件也仍然定义为RoutedEventHandler
。你的自定义事件遵循了这一惯例,使得它看起来和用起来都像一个“标准”的 WPF 路由事件。 -
简化 XAML 书写:在 XAML 中,当你输入
Button.Click=
时,智能感知和编译器期望的是一个RoutedEventHandler
类型的方法。如果你的自定义事件也使用RoutedEventHandler
,那么开发者在为你的TimeButton.ReportTime
事件指定处理程序时,会有完全一致的体验。他们不需要去记忆一个特殊的EventHandler<ReportTimeEventArgs>
类型。 -
历史原因:
EventHandler<T>
泛型委托是在 .NET Framework 2.0 中引入的,而 WPF 的部分设计可能更早,或者为了与早期的设计模式保持一致,选择了使用非泛型的RoutedEventHandler
。这个习惯被保留了下来。
总结
- 技术上可行:因为委托协变,
EventHandler<ReportTimeEventArgs>
与RoutedEventHandler
是兼容的。ReportTimeHandler
方法的签名最终匹配的是事件注册时指定的EventHandler<ReportTimeEventArgs>
。 - 设计上合理:将公共事件包装为
RoutedEventHandler
类型,是为了与 WPF 框架中其他所有路由事件保持一致,提供统一的编程体验。
所以,这并不是一个错误,而是一个遵循 WPF 惯例的、经过深思熟虑的设计。它保证了自定义路由事件在行为和用法上与原生事件无缝集成。