ContentElement.RemoveHandler(RoutedEvent, Delegate) Metoda

Definicja

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.

Dotyczy

Zobacz też