IWeakEventListener IWeakEventListener IWeakEventListener IWeakEventListener Interface

Définition

Prend en charge l'écoute d'événements pour les classes qui doivent recevoir des événements à travers le modèle WeakEvent et WeakEventManager.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
Dérivé

Remarques

Le WeakEventManager (un répartiteur) transfère un événement en appelant la méthode sur les ReceiveWeakEvent classes qui implémentent cette interface, et qui ont été ajoutées en tant qu’écouteurs en appelant WeakEventManager les méthodes au préalable.The 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.

La raison principale pour suivre le modèle WeakEvent est lorsque la source de l’événement a une durée de vie d’objet potentiellement indépendante des écouteurs d’événements.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. L’utilisation de la distribution d’événements centraux WeakEventManager d’un permet aux gestionnaires d’écouteurs d’être récupérés par le garbage collector (ou purgés manuellement), même si la durée de vie de l’objet source s’étend au-delà des écouteurs.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. En revanche, une accroche d’événement += normale à l’aide de ou d’une syntaxe d’événement spécifique à un langage équivalent amène la source potentiellement connectée à conserver une référence forte aux gestionnaires.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. Cela empêche les références de l’écouteur d’être récupérées par le garbage collector en temps opportun.This keeps the listener references from being garbage collected in a timely fashion.

Une situation courante dans laquelle les relations entre les sources et les écouteurs suggère l’utilisation de ce modèle est la gestion des événements de mise à jour provenant de sources pour les liaisons de données.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.

Vous pouvez utiliser le modèle WeakEvent pour écouter les événements qui sont externes à votre application.You can use the WeakEvent pattern to listen for events that are external to your application. Vous devez uniquement définir un pour WeakEventManager celui-ci, fournir un comportement ReceiveWeakEventd’écoute dans, WeakEventManager et utiliser pour attacher les références de +=gestionnaire plutôt que.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 +=.

Méthodes

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

Reçoit des événements du gestionnaire d'événements centralisé.Receives events from the centralized event manager.

S’applique à

Voir aussi