EventListener 클래스

정의

네임스페이스:

System.Diagnostics.Tracing

어셈블리:

System.Diagnostics.Tracing.dll

Source:

EventSource.cs

이벤트 원본에서 이벤트를 사용하거나 사용하지 않도록 설정하는 메서드를 제공합니다.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

상속

Object

EventListener

구현

IDisposable

설명

이벤트 수신기를 이벤트 원본에서 생성 된 모든 이벤트에 대 한 대상을 나타냅니다 (EventSource 개체)는 현재 애플리케이션 도메인에서 구현 합니다. 새 이벤트 수신기를 만들면 해당 애플리케이션 도메인의 모든 이벤트 소스에 논리적으로 연결 됩니다.

참고

이 형식이 구현 하는 IDisposable 인터페이스입니다. 형식 사용을 마쳤으면 직접 또는 간접적으로 삭제해야 합니다. 직접 형식의 dispose 호출 해당 Dispose 의 메서드를 try/catch 블록입니다. 삭제 하지 직접, 언어 구문 같은 사용 using (C#에서) 또는 Using (Visual Basic에서는). 자세한 내용은 "를 사용 하는 개체는 구현 IDisposable" 섹션을 참조 하세요.를 IDisposable 인터페이스 항목입니다.

이벤트 수신기는 이벤트 수준() 및 이벤트 키워드EventKeywords(EventLevel)를 사용하여 수신기에 보낼 이벤트 집합을 추가로 제한하여 현재 이벤트 원본별로 사용하거나 사용하지 않도록 설정할 수 있습니다. 수신기는 메서드를 사용하여 SendCommand 특정 현재 이벤트 원본에 임의의 명령을 보낼 수도 있습니다. 명령의 의미는 이벤트 원본의 구현과 관련이 있습니다.

단일 애플리케이션 도메인에 여러 이벤트 수신기를 정의할 수 있습니다. 각 수신기는 다른 수신기와 논리적으로 독립적이므로 한 수신기에서 사용하거나 사용하지 않도록 설정된 이벤트는 해당 수신기에만 영향을 줍니다. 메서드와 함께 SendCommand 전송된 명령이 다른 수신기에 영향을 주는 의미 체계 작업(예: 가비지 수집 또는 데이터 플러시)을 수행할 수 있지만 규칙이 아닌 예외입니다.

각 이벤트 원본은 이벤트를 보내는 이벤트 수신기 목록을 유지합니다. 필터링 조건 집합은 각 이벤트 원본 수신기 쌍과 연결됩니다. 이러한 조건은 수신기가 현재 이벤트 원본에 대해 수신할 이벤트를 결정합니다. 수신기는 메서드에서 이벤트를 받습니다 OnEventWritten . 따라서 의 EventListener 서브클래스는 데이터에 유용한 작업을 수행하려면 이 메서드를 재정의해야 합니다.

새 이벤트 원본이 만들어지면 메서드가 OnEventSourceCreated 호출됩니다. 모든 현재 이벤트 수신기는 로그 메시지를 보낼 수 있는 모든 현재 이벤트 원본에 대해 정확히 하나의 OnEventSourceCreated 호출을 가져옵니다. 이벤트 수신기가 만들어지면 수신기를 만들기 전에 존재했던 모든 이벤트 원본을 새 수신기에 알리기 위해 일련의 OnEventSourceCreated 호출이 이루어집니다.

중요

를 인스턴스화할 EventListener때 생성자가 완료되기 OnEventSourceCreated전에 및 OnEventWritten 에 대한 콜백이 발생할 수 있습니다. 이러한 콜백에 사용되는 instance 멤버를 초기화할 때 주의해야 합니다.

생성자

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 개체)에 의해 이벤트가 작성될 때 호출됩니다.