Erweitern Minimieren
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

UIElement.RemoveHandler-Methode

Entfernt den angegebenen Routingereignis-Handler für dieses Element.

Namespace:  System.Windows
Assembly:  PresentationCore (in PresentationCore.dll)
public void RemoveHandler(
	RoutedEvent routedEvent,
	Delegate handler
)

Parameter

routedEvent
Typ: System.Windows.RoutedEvent
Der Bezeichner des Routingereignisses, für das der Handler angefügt wurde.
handler
Typ: System.Delegate
Die spezifische aus der Auflistung der Ereignishandler für dieses Element entfernt werden Handlerimplementierung.

Implementiert

IInputElement.RemoveHandler(RoutedEvent, Delegate)

Das häufigste Szenario für die Verwendung dieser API liegt vor, wenn Sie implementieren common language runtime (CLR) „Wrapper“ - Ereignis, das einer benutzerdefinierten zugeordnet ist. Routingereignisspezifisch, wenn Sie „implementieren, entfernen Sie Handler Logik für“ CLR Ebene. Das Beispiel, das diesen Abschnitt " Hinweise " folgt, wird dieses Szenario veranschaulicht.

Das Aufrufen dieser Methode hat keine Auswirkungen, wenn keine Handler mit angegebenen Kriterien registriert wurden, der die Eingabeparameter für den Methodenaufruf entspricht.

Wenn mehr als ein Handler die Kriterien angefügtes das übereinstimmende ist, wird nur der erste Handler auf, wenn der Handler entfernt wird. Dieses Verhalten ist mit konsistent CLR Verhalten -=-Operator.

Keine routedEvent noch handler sein kann null. Versuchen Sie, wie die einzelnen Werte bereitzustellen null löst eine Ausnahme aus.

Diese Methode ignoriert handledEventsToo-Parameter, die bereitgestellt wird, wenn der Handler zuerst mit hinzugefügten AddHandler(RoutedEvent, Delegate, Boolean) Die Signatur, die bereits-behandelte Behandlung von Ereignissen ermöglicht. Jeder Typ Handler entfernt wird.

Im folgenden Beispiel wird RemoveHandler Wrapper Ereignis als Teil der Definition.


public static readonly RoutedEvent TapEvent = EventManager.RegisterRoutedEvent(
    "Tap", RoutingStrategy.Bubble, typeof(RoutedEventHandler), typeof(MyButtonSimple));

// Provide CLR accessors for the event
public event RoutedEventHandler Tap
{
        add { AddHandler(TapEvent, value); } 
        remove { RemoveHandler(TapEvent, value); }
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.