EventListener クラス

定義

名前空間:

System.Diagnostics.Tracing

アセンブリ:

System.Diagnostics.Tracing.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

イベント ソースからのイベントを有効または無効にするメソッドを提供します。

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

注意

この型は IDisposable インターフェイスを実装します。 型の使用が完了したら、直接または間接的に破棄する必要があります。 直接的に型を破棄するには、try/catch ブロック内で Dispose メソッドを呼び出します。 間接的に型を破棄するには、using (C# の場合) または Using (Visual Basic 言語) などの言語構成要素を使用します。 詳細については、IDisposable インターフェイスに関するトピック内の「IDisposable を実装するオブジェクトの使用」セクションを参照してください。

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

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

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

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

重要

インスタンス化するときEventListener、コンストラクターが完了する 前 にOnEventSourceCreatedコールバックが発生する可能性がありますOnEventWritten。 これらのコールバックで使用されるインスタンス メンバーを初期化するときは注意してください。

コンストラクター

EventListener()

EventListener クラスの新しいインスタンスを作成します。

メソッド

DisableEvents(EventSource)	指定したイベント ソースのすべてのイベントを無効にします。
Dispose()	EventListener クラスの現在のインスタンスによって使用されているリソースを解放します。
EnableEvents(EventSource, EventLevel)	指定した詳細レベル以下の指定したイベント ソースのイベントを有効にします。
EnableEvents(EventSource, EventLevel, EventKeywords)	指定した詳細レベル以下で、キーワード フラグが一致している指定したイベント ソースのイベントを有効にします。
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	指定した詳細レベル以下で、イベント キーワード フラグが一致し、引数が一致している指定したイベント ソースのイベントを有効にします。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
EventSourceIndex(EventSource)	指定されたイベント ソースを表す負でない小さい数値を取得します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
OnEventSourceCreated(EventSource)	イベント リスナーが作成される場合や、新しいイベント ソースがリスナーにアタッチされる場合に、既存のすべてのイベント ソースに対して呼び出されます。
OnEventWritten(EventWrittenEventArgs)	イベント リスナーがイベントを有効にしたイベント ソースによってイベントが記述されたときに呼び出されます。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

events

EventSourceCreated	イベント ソース (EventSource オブジェクト) がディスパッチャーにアタッチされている場合に発生します。
EventWritten	イベント リスナーがイベントを有効にしたイベント ソース (EventSource オブジェクト) によってイベントが記述されたときに発生します。