ContentElement.RemoveHandler(RoutedEvent, Delegate) Méthode

Définition

Supprime le gestionnaire d’événements routés spécifié de cet élément.Removes the specified routed event handler from this 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)

Paramètres

routedEvent
RoutedEvent

Identificateur de l’événement routé pour lequel le gestionnaire est attaché.The identifier of the.routed event for which the handler is attached.

handler
Delegate

Implémentation de gestionnaire spécifique à supprimer de la collection de gestionnaires d’événements sur cet élément.The specific handler implementation to remove from the event handler collection on this element.

Implémente

Remarques

Le scénario le plus courant pour l’utilisation de cette API est lorsque vous implémentez l’événement Common Language Runtime (CLR)common language runtime (CLR) « Wrapper » associé à un événement routé personnalisé, en particulier quand vous implémentez la logique « supprimer » pour les gestionnaires au niveau de la CLRCLR.The most common scenario for using this API is when you implement the Common Language Runtime (CLR)common language runtime (CLR) "wrapper" event that is associated with a custom routed event, specifically when you implement the "remove" logic for handlers at the CLRCLR level. L’exemple qui suit cette section Remarques illustre ce scénario.The example that follows this remarks section illustrates this scenario.

L’appel de cette méthode n’a aucun effet si aucun gestionnaire n’est inscrit avec des critères qui correspondent aux paramètres d’entrée pour l’appel de méthode.Calling this method has no effect if there were no handlers registered with criteria that match the input parameters for the method call.

Si plusieurs gestionnaires sont attachés et correspondent aux critères, seul le premier gestionnaire du magasin de gestionnaires d’événements est supprimé.If more than one handler is attached that matched the criteria, only the first handler in the event handler store is removed. Ce comportement est cohérent avec CLRCLR comportement de l’opérateur -=.This behavior is consistent with CLRCLR behavior of the -= operator.

Ni routedEvent ni handler ne peuvent être null.Neither routedEvent nor handler may be null. Toute tentative de fournir une valeur comme null lève une exception.Attempting to provide either value as null will raise an exception.

Cette méthode ignore les informations sur les paramètres handledEventsToo, qui sont fournies si le gestionnaire a été ajouté pour la première fois avec la signature AddHandler(RoutedEvent, Delegate, Boolean) qui permet de gérer les événements déjà gérés.This method ignores the handledEventsToo parameter information, which is provided if the handler was first added with the AddHandler(RoutedEvent, Delegate, Boolean) signature that enables handling of already-handled events. L’un ou l’autre type de gestionnaire est supprimé.Either type of handler is removed.

S’applique à

Voir aussi