EventListener EventListener EventListener EventListener Class

定義

イベント ソースからのイベントを有効または無効にするメソッドを提供します。Provides methods for enabling and disabling events from event sources.

public ref class EventListener abstract : IDisposable
public abstract class EventListener : IDisposable
type EventListener = class
    interface IDisposable
Public MustInherit Class EventListener
Implements IDisposable
継承
EventListenerEventListenerEventListenerEventListener
実装

注釈

イベント リスナーがイベント ソースによって生成されたすべてのイベントのターゲットを表します (EventSourceオブジェクト)、現在のアプリケーション ドメインで実装します。An event listener represents the target for all events generated by event source (EventSource object) implementations in the current application domain. 新しいイベント リスナーが作成されると、論理的にそのアプリケーション ドメイン内のすべてのイベント ソースにアタッチされています。When a new event listener is created, it is logically attached to all event sources in that application domain.

注意

この型は IDisposable インターフェイスを実装します。This type implements the IDisposable interface. 型の使用が完了したら、直接または間接的にその破棄する必要があります。When you have finished using the type, you must dispose of it either directly or indirectly. 直接的に型を破棄するには、try / catch ブロック内で Dispose メソッドを呼び出します。To dispose of the type directly, call its Dispose method in a try/catch block. 間接的に型を破棄するには、using (C# の場合) または Using (Visual Basic 言語) などの言語構成要素を使用します。To dispose of it indirectly, use a language construct such as using (in C#) or Using (in Visual Basic). 詳細については、IDisposable インターフェイスに関するトピック内の「IDisposable を実装するオブジェクトの使用」セクションを参照してください。For more information, see the "Using an Object that Implements IDisposable" section in the IDisposable interface topic.

イベント リスナーを有効または - 現在のイベント ソースごとにイベント レベルを使用して無効にできます (EventLevel) とイベントのキーワード (EventKeywords) をさらに、リスナーに送信されるイベントのセットを制限します。An event listener can enable or disable on a per-current event source basis by using event levels (EventLevel) and event keywords (EventKeywords) to further restrict the set of events to be sent to the listener. リスナーを使用して現在の特定のイベント ソースを任意のコマンドを送信もことができます、SendCommandメソッド。The listener can also send arbitrary commands to a specific current event source by using the SendCommand method. コマンドの意味は、イベント ソースの実装に固有です。The meanings of the commands are specific to the implementation of the event source.

場合、Guidプロパティ、EventSource有効またはイベントを無効にするために使用するオブジェクトは、 Empty、アプリケーション ドメイン内のすべてのイベント ソースが影響を受けます。If the Guid property in the EventSource object that is used to enable or disable events is Empty, all event sources in the application domain are affected.

複数のイベント リスナーは、1 つのアプリケーション ドメインで定義できます。Multiple event listeners can be defined in a single application domain. 各リスナーは、1 つのリスナーでは無効または有効にするイベントがそのリスナーのみに影響するために他のリスナーの論理的に独立しました。Each listener is logically independent of the other listeners so that events that are enabled or disabled by one listener affect only that listener. コマンドで送信される可能性があります、SendCommandすることにより、他のリスナーに影響しますが、これが、ルールではなく、例外がある (ガベージ コレクションやデータのフラッシュ) などのセマンティックの操作を実行します。It is possible for commands sent with the SendCommand method to do a semantic operation (such as a garbage collection or flushing data) that affects the other listeners, but this is the exception rather than the rule.

各イベントのソースは、イベントを送信するイベント リスナーのリストを保持します。Each event source keeps a list of event listeners that it sends events to. フィルターの条件のセットは、各イベントのソース リスナー ペアに関連付けられます。A set of filtering criteria is associated with each event source-listener pair. これらの条件の確認イベント リスナーは、現在のイベント ソースを受け取ります。These criteria determine the events that listener will receive for the current event source. リスナーでイベントを受信する、OnEventWrittenメソッド。Listeners receive the events on their OnEventWritten method. サブクラスではそのため、EventListenerデータでこのメソッドをオーバーライドする必要があります。Therefore, subclasses of EventListener must override this method to do something useful with the data.

新しいイベント ソースが作成されたときに、OnEventSourceCreatedメソッドが呼び出されます。When a new event source is created, the OnEventSourceCreated method is called. すべて現在のイベント リスナーが 1 つだけを取得OnEventSourceCreatedに送信できるすべての現在のイベント ソースのメッセージを記録します。Every current event listener gets exactly one OnEventSourceCreated call for every current event source that can send it log messages. イベント リスナーが作成されたとき、一連のOnEventSourceCreatedリスナーが作成される前に存在していたすべてのイベント ソースの新しいリスナーに通知する呼び出しは行われます。When an event listener is created, a series of OnEventSourceCreated calls are made to notify the new listener of all the event sources that existed before the listener was created.

コンストラクター

EventListener() EventListener() EventListener() EventListener()

EventListener クラスの新しいインスタンスを作成します。Creates a new instance of the EventListener class.

メソッド

DisableEvents(EventSource) DisableEvents(EventSource) DisableEvents(EventSource) DisableEvents(EventSource)

指定したイベント ソースのすべてのイベントを無効にします。Disables all events for the specified event source.

Dispose() Dispose() Dispose() Dispose()

EventListener クラスの現在のインスタンスによって使用されているリソースを解放します。Releases the resources used by the current instance of the EventListener class.

EnableEvents(EventSource, EventLevel) EnableEvents(EventSource, EventLevel) EnableEvents(EventSource, EventLevel) EnableEvents(EventSource, EventLevel)

指定した詳細レベル以下の指定したイベント ソースのイベントを有効にします。Enables events for the specified event source that has the specified verbosity level or lower.

EnableEvents(EventSource, EventLevel, EventKeywords) EnableEvents(EventSource, EventLevel, EventKeywords) EnableEvents(EventSource, EventLevel, EventKeywords) EnableEvents(EventSource, EventLevel, EventKeywords)

指定した詳細レベル以下で、キーワード フラグが一致している指定したイベント ソースのイベントを有効にします。Enables events for the specified event source that has the specified verbosity level or lower, and matching keyword flags.

EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>) EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>) EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>) EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)

指定した詳細レベル以下で、イベント キーワード フラグが一致し、引数が一致している指定したイベント ソースのイベントを有効にします。Enables events for the specified event source that has the specified verbosity level or lower, matching event keyword flag, and matching arguments.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
EventSourceIndex(EventSource) EventSourceIndex(EventSource) EventSourceIndex(EventSource) EventSourceIndex(EventSource)

指定されたイベント ソースを表す負でない小さい数値を取得します。Gets a small non-negative number that represents the specified event source.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
OnEventSourceCreated(EventSource) OnEventSourceCreated(EventSource) OnEventSourceCreated(EventSource) OnEventSourceCreated(EventSource)

イベント リスナーが作成される場合や、新しいイベント ソースがリスナーにアタッチされる場合に、既存のすべてのイベント ソースに対して呼び出されます。Called for all existing event sources when the event listener is created and when a new event source is attached to the listener.

OnEventWritten(EventWrittenEventArgs) OnEventWritten(EventWrittenEventArgs) OnEventWritten(EventWrittenEventArgs) OnEventWritten(EventWrittenEventArgs)

イベント リスナーがイベントを有効にしたイベント ソースによってイベントが記述されたときに呼び出されます。Called whenever an event has been written by an event source for which the event listener has enabled events.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

イベント

EventSourceCreated EventSourceCreated EventSourceCreated EventSourceCreated

イベント ソース (EventSource オブジェクト) がディスパッチャーにアタッチされている場合に発生します。Occurs when an event source (EventSource object) is attached to the dispatcher.

EventWritten EventWritten EventWritten EventWritten

イベント リスナーがイベントを有効にしたイベント ソース (EventSource オブジェクト) によってイベントが記述されたときに発生します。Occurs when an event has been written by an event source (EventSource object) for which the event listener has enabled events.

適用対象