EventListener クラス

定義

public ref class EventListener abstract : IDisposable

public ref class EventListener : IDisposable

public abstract class EventListener : IDisposable

public class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Public Class EventListener
Implements IDisposable

継承

Object

EventListener

実装

IDisposable

注釈

イベント リスナーは、現在のアプリケーション ドメインのイベント ソース (EventSource オブジェクト) 実装によって生成されるすべてのイベントのターゲットを表します。 新しいイベント リスナーが作成されると、そのアプリケーション ドメイン内のすべてのイベント ソースに論理的にアタッチされます。

イベント リスナーは、イベント レベル (EventLevel) とイベント キーワード (EventKeywords) を使用して、リスナーに送信されるイベントのセットをさらに制限することで、現在のイベント ソースごとに有効または無効にすることができます。 リスナーは、 SendCommand メソッドを使用して、特定の現在のイベント ソースに任意のコマンドを送信することもできます。 コマンドの意味は、イベント ソースの実装に固有です。

1 つのアプリケーション ドメインに複数のイベント リスナーを定義できます。 各リスナーは他のリスナーから論理的に独立しているため、1 つのリスナーによって有効または無効になっているイベントは、そのリスナーにのみ影響します。 SendCommand メソッドで送信されたコマンドは、他のリスナーに影響を与えるセマンティック操作 (ガベージ コレクションやデータのフラッシュなど) を実行できますが、これはルールではなく例外です。

各イベント ソースは、イベントを送信するイベント リスナーの一覧を保持します。 フィルター条件のセットは、各イベント ソースとリスナーのペアに関連付けられます。 これらの条件によって、リスナーが現在のイベント ソースに対して受信するイベントが決まります。 リスナーは、 OnEventWritten メソッドでイベントを受信します。 したがって、 EventListener のサブクラスは、データに役立つ処理を行うために、このメソッドをオーバーライドする必要があります。

新しいイベント ソースが作成されると、 OnEventSourceCreated メソッドが呼び出されます。 すべての現在のイベント リスナーは、ログ メッセージを送信できるすべての現在のイベント ソースに対して 1 つの OnEventSourceCreated 呼び出しを取得します。 イベント リスナーが作成されると、リスナーが作成される前に存在していたすべてのイベント ソースを新しいリスナーに通知するために、一連の OnEventSourceCreated 呼び出しが行われます。