IWeakEventListener IWeakEventListener IWeakEventListener IWeakEventListener Interface

Definition

Unterstützt Klassen, die Ereignisse über das WeakEvent-Muster erwarten, bei der Überwachung von Ereignissen und stellt einen WeakEventManager bereit.Provides event listening support for classes that expect to receive events through the WeakEvent pattern and a WeakEventManager.

public interface class IWeakEventListener
public interface IWeakEventListener
type IWeakEventListener = interface
Public Interface IWeakEventListener
Abgeleitet

Hinweise

(Ein Verteiler) leitet ein Ereignis durch Aufrufen der ReceiveWeakEvent -Methode für Klassen weiter, die diese Schnittstelle implementieren, und die als Listener hinzugefügt wurden WeakEventManager , indem Methoden vorher aufgerufen wurden. WeakEventManagerThe WeakEventManager (a dispatcher) forwards an event by calling the ReceiveWeakEvent method on classes that implement this interface, and that have been added as listeners by calling WeakEventManager methods beforehand.

Der Hauptgrund für das Muster von WeakEvent besteht darin, dass die Ereignis Quelle über eine Objekt Lebensdauer verfügt, die potenziell unabhängig von den Ereignislistenern ist.The principal reason for following the WeakEvent pattern is when the event source has an object lifetime that is potentially independent of the event listeners. Durch die Verwendung der zentralen Ereignis Verteilung eines WeakEventManager können die Handler für Listener in eine Garbage Collection (oder manuell gelöscht) werden, auch wenn die Lebensdauer des Quell Objekts über die Listener hinausgeht.Using the central event dispatching of a WeakEventManager enables the handlers for listeners to be garbage collected (or manually purged) even if the source object lifetime extends beyond the listeners. Im Gegensatz dazu bewirkt eine normale Ereignis Einbindung mit += oder einer entsprechenden sprachspezifischen Ereignis Syntax, dass die möglicherweise noch verbundene Quelle einen starken Verweis auf die Handler enthält.By contrast, a normal event hookup using += or equivalent language-specific event syntax causes the potentially still-connected source to hold a strong reference to the handlers. Dadurch wird verhindert, dass die listenerverweise rechtzeitig bereinigt werden.This keeps the listener references from being garbage collected in a timely fashion.

Eine häufige Situation, in der die Beziehungen zwischen Quellen und Listenern die Verwendung dieses Musters nahelegen, ist die Behandlung von Update Ereignissen aus Quellen für Daten Bindungen.One common situation where the relationships between sources and listeners suggests the use of this pattern is the handling of update events coming from sources for data bindings.

Sie können das WeakEvent-Muster verwenden, um auf Ereignisse zu lauschen, die sich außerhalb Ihrer Anwendung befinden.You can use the WeakEvent pattern to listen for events that are external to your application. WeakEventManager Sie müssen nur eine für die IT definieren, das Überwachungs Verhalten in ReceiveWeakEventbereitstellen und zum Anfügen der Handlerverweise anstelle += WeakEventManager von verwenden.You only need to define a WeakEventManager for it, provide listening behavior in ReceiveWeakEvent, and use the WeakEventManager to attach the handler references rather than +=.

Methoden

ReceiveWeakEvent(Type, Object, EventArgs) ReceiveWeakEvent(Type, Object, EventArgs) ReceiveWeakEvent(Type, Object, EventArgs) ReceiveWeakEvent(Type, Object, EventArgs)

Empfängt Ereignisse vom zentralen Ereignis-Manager.Receives events from the centralized event manager.

Gilt für:

Siehe auch