IWeakEventListener IWeakEventListener IWeakEventListener IWeakEventListener Interface

Определение

Предоставляет поддержку прослушивания событий для классов, ожидающих получения событий через шаблон WeakEvent и 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
Производный

Комментарии

WeakEventManager (Диспетчер) пересылает события путем вызова ReceiveWeakEvent метод в классах, которые реализуют этот интерфейс, и, были добавлены в качестве прослушивателей, вызвав WeakEventManager методы заранее.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.

Следующий шаблон WeakEvent основной причиной является после источника события времени жизни объекта, потенциально независимого от прослушивателей событий.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. С помощью централизованной диспетчеризации событий WeakEventManager включает обработчики прослушивателей сборщику мусора собранные (или ручной очистке) даже если время жизни объекта источника выходит за пределы прослушиватели.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. Напротив привязка обычных событий с помощью += или потенциально постоянного подключенного источника, для хранения строгую ссылку на обработчик вызывает синтаксис эквивалентного события конкретного языка.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. Это позволяет сборщику мусора своевременно ссылки прослушивателя.This keeps the listener references from being garbage collected in a timely fashion.

Одна из распространенных ситуаций, где связи между источниками и прослушивателями предлагает использовать этот шаблон является обработка событий обновления, поступающих из источников для привязок данных.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.

Шаблон WeakEvent можно использовать для прослушивания событий, которые являются внешними по отношению к приложению.You can use the WeakEvent pattern to listen for events that are external to your application. Необходимо определить WeakEventManager , обеспечить прослушивания поведение в ReceiveWeakEventи использовать WeakEventManager присоединить обработчик ссылающегося вместо +=.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 +=.

Методы

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

Получает события от централизованного диспетчера событий.Receives events from the centralized event manager.

Применяется к

Дополнительно