資訊
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

UIElement.RemoveHandler 方法

更新:2007 年 11 月

從這個項目中移除指定的路由事件處理常式。

命名空間:  System.Windows
組件:  PresentationCore (在 PresentationCore.dll 中)

public void RemoveHandler(
	RoutedEvent routedEvent,
	Delegate handler
)
public final void RemoveHandler(
	RoutedEvent routedEvent,
	Delegate handler
)
public final function RemoveHandler(
	routedEvent : RoutedEvent, 
	handler : Delegate
)
您不能在 XAML 使用方法。

參數

routedEvent
型別:System.Windows.RoutedEvent

要附加處理常式之路由事件的識別項。

handler
型別:System.Delegate

要從這個項目的事件處理常式集合中移除的特定處理常式實作。

實作

IInputElement.RemoveHandler(RoutedEvent, Delegate)

最常見的使用這個 API 的案例,就是實作與自訂路由事件關聯的 Common Language Runtime (CLR)「包裝函式」事件,特別是在 CLR 層級實作處理常式的「移除」邏輯。此「備註」章節後面的範例會說明這個案例。

如果沒有任何處理常式以符合方法呼叫之輸入參數的準則註冊,則呼叫這個方法將沒有作用。

如果附加了超過一個符合準則的處理常式,則只會移除事件處理常式存放區中的第一個處理常式。此行為與 -= 運算子的 CLR 行為一致。

routedEventhandler 都不可為 null。嘗試以 null 提供任一個值,都會引發例外狀況。

這個方法會忽略 handledEventsToo 參數資訊,如果處理常式是先以可啟用已處理事件之處理的 AddHandler(RoutedEvent, Delegate, Boolean) 簽章加入,就會提供該資訊。移除任一型別的處理常式。

下列範例會使用 RemoveHandler 做為事件包裝函式定義的一部分。

Public Shared ReadOnly TapEvent As RoutedEvent = EventManager.RegisterRoutedEvent("Tap", RoutingStrategy.Bubble, GetType(RoutedEventHandler), GetType(MyButtonSimple))

' Provide CLR accessors for the event
Public Custom Event Tap As RoutedEventHandler
    AddHandler(ByVal value As RoutedEventHandler)
        Me.AddHandler(TapEvent, value)
    End AddHandler

    RemoveHandler(ByVal value As RoutedEventHandler)
        Me.RemoveHandler(TapEvent, value)
    End RemoveHandler

    RaiseEvent(ByVal sender As Object, ByVal e As RoutedEventArgs)
        Me.RaiseEvent(e)
    End RaiseEvent
End Event


Windows Vista

.NET Framework 和 .NET Compact Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊,請參閱.NET Framework 系統需求

.NET Framework

支援版本:3.5、3.0

社群新增項目

顯示:
© 2015 Microsoft