ContentElement.RemoveHandler(RoutedEvent, Delegate) 方法

定義

命名空間:

System.Windows

組件:

PresentationCore.dll

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

public:
 virtual void RemoveHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);

public void RemoveHandler (System.Windows.RoutedEvent routedEvent, Delegate handler);

abstract member RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit
override this.RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit

Public Sub RemoveHandler (routedEvent As RoutedEvent, handler As Delegate)

參數

routedEvent

RoutedEvent

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

handler

Delegate

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

實作

RemoveHandler(RoutedEvent, Delegate)

備註

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

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

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

routedEvent和 handler 都不能是 null 。 嘗試提供任一值，因為 null 會引發例外狀況。

這個方法會 handledEventsToo 忽略參數資訊，如果處理常式第一次以簽章新增 AddHandler(RoutedEvent, Delegate, Boolean) ，可處理已處理的事件，則會提供這個資訊。 已移除任一類型的處理常式。

另請參閱

• AddHandler(RoutedEvent, Delegate)