ContentElement.RemoveHandler(RoutedEvent, Delegate) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
移除此元素中指定的路由事件處理器。
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
處理器所附加的 .routed 事件識別碼。
- handler
- Delegate
該元素的事件處理集合中移除的特定處理程式實作。
實作
備註
使用此 API 最常見的情境是當你實作與自訂路由事件相關的通用語言執行時(CLR)「包裝」事件,特別是在 CLR 層級實作處理器的「移除」邏輯時。 以下說明段落的例子說明了此情境。
若沒有符合輸入參數的處理程序註冊,呼叫此方法不會生效。
如果連接多個符合條件的處理器,事件處理器庫中僅移除第一個處理器。 此行為與操作員的CLR行為 -= 一致。
既不是routedEvent,也handler不是。null 嘗試提供任一價值 null 都會觸發例外。
此方法忽略 handledEventsToo 參數資訊,若處理器最初加入能 AddHandler(RoutedEvent, Delegate, Boolean) 處理已處理事件的簽章,則會提供參數資訊。 兩種類型的處理員都會被移除。