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.

ソースとリスナー間のリレーションシップがこのパターンの使用を提案する、1 つの一般的な状況は、データ バインディングのソースから更新プログラムのイベントを処理します。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.

適用対象

こちらもご覧ください