ContentElement.RemoveHandler(RoutedEvent, Delegate) Metódus

Definíció

Eltávolítja a megadott irányított eseménykezelőt ebből az elemből.

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éterek

routedEvent
RoutedEvent

Annak a.routed eseménynek az azonosítója, amelyhez a kezelő csatlakoztatva van.

handler
Delegate

Az adott kezelő implementációja, amely eltávolítható az elem eseménykezelő gyűjteményéből.

Megvalósítás

Megjegyzések

Az API használatának leggyakoribb forgatókönyve a közös nyelvi futtatókörnyezeti (CLR) "burkoló" esemény implementálása, amely egy egyéni irányított eseményhez van társítva, különösen akkor, ha a kezelők számára a CLR szintjén implementálja a "remove" logikát. A megjegyzéseket követő példa ezt a forgatókönyvet szemlélteti.

A metódus meghívásának nincs hatása, ha nem regisztráltak olyan kezelőket, amelyek megfelelnek a metódushívás bemeneti paramétereinek.

Ha több olyan kezelő van csatlakoztatva, amely megfelel a feltételeknek, csak az eseménykezelő tár első kezelője lesz eltávolítva. Ez a viselkedés összhangban van az -= operátor CLR-viselkedésével.

Sem routedEvent nem handler lehet null. Ha bármelyik értéket megkísérli megadni, az null kivételt fog eredményezni.

Ez a módszer figyelmen kívül hagyja a handledEventsToo paraméteradatokat, amelyek akkor lesznek megadva, ha a kezelőt először hozzáadták az AddHandler(RoutedEvent, Delegate, Boolean) aláírással, amely lehetővé teszi a már kezelt események kezelését. A rendszer eltávolítja a kezelő egyik típusát.

A következőre érvényes:

Lásd még