IWeakEventListener IWeakEventListener IWeakEventListener IWeakEventListener Interface

Definición

Proporciona compatibilidad con la escucha de eventos para las clases que esperan recibir eventos a través del modelo WeakEvent y 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
Derivado

Comentarios

El WeakEventManager (un distribuidor) reenvía un evento mediante una llamada a la ReceiveWeakEvent método en las clases que implementan esta interfaz, y que se han agregado como agentes de escucha mediante una llamada a WeakEventManager métodos con antelación.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 principal razón para seguir el patrón WeakEvent es cuando el origen de eventos tiene una duración del objeto que es potencialmente independiente de los agentes de escucha de eventos.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. Mediante el envío de eventos central de un WeakEventManager habilita los controladores para los agentes de escucha de elementos no utilizados recopilan (o la depuración manual) incluso si la duración del objeto de origen se extiende más allá de los agentes de escucha.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. Por el contrario, un enlace de eventos normal mediante += o sintaxis de eventos específica del lenguaje equivalente hace que el origen podría seguir conectado contener una referencia segura a los controladores.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. Esto evita que las referencias del agente de escucha que se recopila de manera oportuna.This keeps the listener references from being garbage collected in a timely fashion.

Una situación común donde las relaciones entre orígenes y los agentes de escucha sugiere el uso de este patrón es el control de eventos de actualización procedentes de orígenes para los enlaces de datos.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.

Puede usar el patrón WeakEvent para escuchar los eventos que son externos a la aplicación.You can use the WeakEvent pattern to listen for events that are external to your application. Solo necesita definir un WeakEventManager , proporcionar el comportamiento de escucha en ReceiveWeakEventy usar el WeakEventManager para asociar el controlador de referencias en lugar de +=.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étodos

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

Recibe los eventos del administrador de eventos centralizado.Receives events from the centralized event manager.

Se aplica a

Consulte también: