UIElement.RemoveHandler 方法

2013/12/13

从此 UIElement 中移除指定的路由事件处理程序。

Namespace:  System.Windows
程序集:  System.Windows(位于 System.Windows.dll 中)

public void RemoveHandler(
	RoutedEvent routedEvent,
	Delegate handler
)

参数

routedEvent
类型: System.Windows.RoutedEvent
附加了处理程序的路由事件的标识符。
handler
类型: System.Delegate
要从此 UIElement 上的事件处理程序集合中移除的特定处理程序实现。

异常条件
ArgumentNullException

routedEvent handlernull.

ArgumentException

routedEvent 不表示支持的路由事件。

- 或 -

handler 不实现支持的委托。

NotImplementedException

试图为当前平台的变体不支持的事件移除处理程序。

重要说明重要说明:

RemoveHandler 只能用于 AddHandler 支持的事件的事件处理程序。不能使用 RemoveHandler 来移除使用语言特定事件连接语法(如 C# 中的 +=)或使用 XAML 中的事件属性添加的常规事件的处理程序。对这样的事件处理程序,应改为使用语言特定的事件处理程序断开连接/移除语法(如 C# 中的 -=)。

如果不存在用与该方法调用的输入参数匹配的条件注册的处理程序,则调用此方法将不起任何作用。

如果附加了多个与该条件匹配的处理程序,则只移除事件处理程序存储区中的第一个处理程序。此行为与 -= 运算符的 CLR 行为是一致的。

routedEventhandler 都不能为 null。尝试提供上述任一值作为 null 都将会引发异常。

此方法将忽略对称 AddHandler 调用的 handledEventsToo 参数信息。

Windows Phone OS

受以下版本支持: 8.0, 7.1, 7.0

Windows Phone

显示:
© 2015 Microsoft