EventListener クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
イベント ソースからのイベントを有効または無効にするメソッドを提供します。
public ref class EventListener abstract : IDisposablepublic ref class EventListener : IDisposablepublic abstract class EventListener : IDisposablepublic class EventListener : IDisposabletype EventListener = class
interface IDisposablePublic MustInherit Class EventListener
Implements IDisposablePublic Class EventListener
Implements IDisposable- 継承
-
EventListener
- 実装
注釈
イベント リスナーは、現在のアプリケーション ドメイン内のイベント ソース (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インスタンス化すると、 と へのOnEventSourceCreatedOnEventWrittenコールバックは、コンストラクターが完了する前に発生する可能性があります。 これらのコールバックで使用されるインスタンス メンバーを初期化するときは注意してください。
コンストラクター
| 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) |
イベント
| EventSourceCreated |
イベント ソース (EventSource オブジェクト) がディスパッチャーにアタッチされている場合に発生します。 |
| EventWritten |
イベント リスナーがイベントを有効にしたイベント ソース (EventSource オブジェクト) によってイベントが記述されたときに発生します。 |
適用対象
.NET