ContentElement.RemoveHandler(RoutedEvent, Delegate) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Usuwa określoną procedurę obsługi zdarzeń kierowanych z tego elementu.
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)
Parametry
- routedEvent
- RoutedEvent
Identyfikator zdarzenia routed, dla którego jest dołączony program obsługi.
- handler
- Delegate
Określona implementacja procedury obsługi do usunięcia z kolekcji programu obsługi zdarzeń w tym elemecie.
Implementuje
Uwagi
Najbardziej typowym scenariuszem korzystania z tego interfejsu API jest zaimplementowanie zdarzenia "otoki" środowiska uruchomieniowego języka wspólnego (CLR), które jest skojarzone z niestandardowym zdarzeniem kierowanym, w szczególności podczas implementowania logiki "usuń" dla programów obsługi na poziomie CLR. W przykładzie, który jest zgodny z tą sekcją uwag, przedstawiono ten scenariusz.
Wywołanie tej metody nie ma wpływu, jeśli nie zarejestrowano procedur obsługi przy użyciu kryteriów spełniających parametry wejściowe wywołania metody.
Jeśli dołączono więcej niż jedną procedurę obsługi zgodną z kryteriami, usunięto tylko pierwszą procedurę obsługi w magazynie programu obsługi zdarzeń. To zachowanie jest spójne z zachowaniem -=
środowiska CLR operatora.
Ani routedEvent
handler
nie może być null
. Próba podania jednej z tych wartości null
spowoduje wystąpienie wyjątku.
Ta metoda ignoruje handledEventsToo
informacje o parametrach, które są udostępniane, jeśli program obsługi został po raz pierwszy dodany z podpisem AddHandler(RoutedEvent, Delegate, Boolean) , który umożliwia obsługę już obsługiwanych zdarzeń. Usuwany jest dowolny typ procedury obsługi.