EventListener 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이벤트 원본에서 이벤트를 사용하도록 설정하고 사용하지 않도록 설정하는 메서드를 제공합니다.
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
- 상속
-
EventListener
- 구현
설명
이벤트 수신기는 현재 애플리케이션 도메인의 이벤트 원본(EventSource 개체) 구현에 의해 생성된 모든 이벤트의 대상을 나타냅니다. 새 이벤트 수신기가 만들어지면 해당 애플리케이션 도메인의 모든 이벤트 원본에 논리적으로 연결됩니다.
메모
이 형식은 IDisposable 인터페이스를 구현합니다. 형식 사용을 마쳤으면 직접 또는 간접적으로 삭제해야 합니다. 형식을 직접 삭제하려면 Disposetry/ 블록에서 해당 catch 메서드를 호출합니다. 간접적으로 삭제하려면 using(C#) 또는 Using(Visual Basic)와 같은 언어 구문을 사용합니다. 자세한 내용은 인터페이스 항목의 "IDisposable을 구현하는 개체 사용" 섹션을 IDisposable 참조하세요.
이벤트 수신기는 이벤트 수준() 및 이벤트 키워드EventLevel(EventKeywords)를 사용하여 현재 이벤트 원본별로 사용하거나 사용하지 않도록 설정하여 수신기로 보낼 이벤트 집합을 추가로 제한할 수 있습니다. 수신기는 메서드를 사용하여 SendCommand 특정 현재 이벤트 원본에 임의의 명령을 보낼 수도 있습니다. 명령의 의미는 이벤트 원본의 구현과 관련이 있습니다.
여러 이벤트 수신기는 단일 애플리케이션 도메인에서 정의할 수 있습니다. 각 수신기는 다른 수신기와 논리적으로 독립적이므로 한 수신기에서 사용하거나 사용하지 않도록 설정된 이벤트는 해당 수신기에만 영향을 줍니다. 메서드와 함께 SendCommand 전송된 명령이 다른 수신기에 영향을 주는 의미 체계 작업(예: 가비지 수집 또는 데이터 플러시)을 수행할 수 있지만 이는 규칙이 아닌 예외입니다.
각 이벤트 원본은 이벤트를 보내는 이벤트 수신기 목록을 유지합니다. 필터링 조건 집합은 각 이벤트 원본 수신기 쌍과 연결됩니다. 이러한 조건은 수신기가 현재 이벤트 원본에 대해 수신할 이벤트를 결정합니다. 수신기는 메서드에서 이벤트를 받습니다 OnEventWritten . 따라서 서브클래스는 데이터에 유용한 작업을 수행하려면 이 메서드를 재정의 EventListener 해야 합니다.
새 이벤트 원본을 만들면 메서드가 OnEventSourceCreated 호출됩니다. 모든 현재 이벤트 수신기는 로그 메시지를 보낼 수 있는 모든 현재 이벤트 원본에 대해 정확히 하나의 OnEventSourceCreated 호출을 받습니다. 이벤트 수신기를 만들면 수신기를 만들기 전에 존재했던 모든 이벤트 원본을 새 수신기에 알리기 위해 일련의 OnEventSourceCreated 호출이 이루어집니다.
Important
인스턴스화할 EventListener때 생성자가 완료되기 OnEventSourceCreatedOnEventWritten전에 콜백이 발생할 수 있습니다. 이러한 콜백에 사용되는 인스턴스 멤버를 초기화할 때 주의해야 합니다.
생성자
| Name | Description |
|---|---|
| EventListener() |
클래스의 새 인스턴스를 EventListener 만듭니다. |
메서드
| Name | Description |
|---|---|
| DisableEvents(EventSource) |
지정된 이벤트 원본에 대한 모든 이벤트를 사용하지 않도록 설정합니다. |
| Dispose() |
클래스의 현재 인스턴스에서 사용하는 리소스를 해제합니다 EventListener . |
| EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>) |
지정된 세부 정보 표시 수준 이하, 일치하는 이벤트 키워드 플래그 및 일치하는 인수를 포함하는 지정된 이벤트 원본에 대한 이벤트를 사용하도록 설정합니다. |
| EnableEvents(EventSource, EventLevel, EventKeywords) |
지정된 세부 정보 표시 수준 이하와 일치하는 키워드 플래그를 포함하는 지정된 이벤트 원본에 대한 이벤트를 사용하도록 설정합니다. |
| EnableEvents(EventSource, EventLevel) |
지정한 세부 정보 표시 수준 이하의 지정된 이벤트 원본에 대한 이벤트를 사용하도록 설정합니다. |
| Equals(Object) |
지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object) |
| EventSourceIndex(EventSource) |
지정된 이벤트 원본을 나타내는 음수가 아닌 작은 숫자를 가져옵니다. |
| GetHashCode() |
기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object) |
| GetType() |
현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object) |
| MemberwiseClone() |
현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| OnEventSourceCreated(EventSource) |
이벤트 수신기가 만들어지고 새 이벤트 원본이 수신기에 연결된 경우 모든 기존 이벤트 원본에 대해 호출됩니다. |
| OnEventWritten(EventWrittenEventArgs) |
이벤트 수신기가 이벤트를 사용하도록 설정한 이벤트 원본에 의해 이벤트가 기록될 때마다 호출됩니다. |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
이벤트
| Name | Description |
|---|---|
| EventSourceCreated |
이벤트 원본(EventSource 개체)이 디스패처에 연결되면 발생합니다. |
| EventWritten |
이벤트 수신기가 이벤트를 사용하도록 설정한 이벤트 원본(EventSource 개체)에서 이벤트를 작성한 경우에 발생합니다. |