ContentElement.RemoveHandler(RoutedEvent, Delegate) Methode

Definitie

Hiermee verwijdert u de opgegeven gerouteerde gebeurtenis-handler uit dit element.

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)

Parameters

routedEvent
RoutedEvent

De id van de.routed-gebeurtenis waarvoor de handler is gekoppeld.

handler
Delegate

De specifieke handler-implementatie die moet worden verwijderd uit de verzameling gebeurtenishandlers op dit element.

Implementeringen

Opmerkingen

Het meest voorkomende scenario voor het gebruik van deze API is wanneer u de clr-gebeurtenis (Common Language Runtime) implementeert die is gekoppeld aan een aangepaste gerouteerde gebeurtenis, met name wanneer u de logica 'remove' implementeert voor handlers op CLR-niveau. Het voorbeeld dat volgt op deze sectie met opmerkingen illustreert dit scenario.

Het aanroepen van deze methode heeft geen effect als er geen handlers zijn geregistreerd bij criteria die overeenkomen met de invoerparameters voor de methode-aanroep.

Als er meer dan één handler is gekoppeld die aan de criteria voldoet, wordt alleen de eerste handler in het gebeurtenishandlerarchief verwijderd. Dit gedrag is consistent met CLR-gedrag van de -= operator.

Noch routedEvent mag het zijnnull.handler Als u een van beide waarden null probeert op te geven, wordt er een uitzondering gegenereerd.

Deze methode negeert de handledEventsToo parameterinformatie, die wordt opgegeven als de handler voor het eerst is toegevoegd met de AddHandler(RoutedEvent, Delegate, Boolean) handtekening waarmee al afgehandelde gebeurtenissen kunnen worden verwerkt. Elk type handler wordt verwijderd.

Van toepassing op

Zie ook