ContentElement.RemoveHandler(RoutedEvent, Delegate) Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Удаляет указанный обработчик маршрутизируемого события из этого элемента.
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 -> unitPublic Sub RemoveHandler (routedEvent As RoutedEvent, handler As Delegate)- routedEvent
- RoutedEvent
Идентификатор перенаправленного события, к которому присоединен обработчик.
- handler
- Delegate
Конкретная реализация удаляемого обработчика из коллекции обработчиков событий этого элемента.
Наиболее распространенный сценарий использования этого API заключается в реализации события среды CLR , связанного с пользовательским перенаправленным событием, в частности при реализации логики удаления для обработчиков на уровне СРЕДЫ CLR. Пример, приведенный ниже в этом разделе примечаний, иллюстрирует этот сценарий.
Вызов этого метода не влияет на отсутствие обработчиков, зарегистрированных с помощью условий, которые соответствуют входным параметрам для вызова метода.
Если несколько обработчиков подключены, соответствующие условиям, удаляется только первый обработчик в хранилище обработчиков событий. Это поведение согласуется с поведением -= оператора CLR.
Ни не routedEvent handler может быть null. Попытка указать любое значение, как null это приведет к возникновению исключения.
Этот метод игнорирует handledEventsToo сведения о параметрах, которые предоставляются при первом добавлении обработчика с подписью AddHandler(RoutedEvent, Delegate, Boolean) , которая обеспечивает обработку уже обработанных событий. Удаляется любой тип обработчика.
| Продукт | Версии |
|---|---|
| .NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8 |
| Windows Desktop | 3.0, 3.1, 5, 6, 7 |