ContentElement.RemoveHandler(RoutedEvent, Delegate) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.