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 接口。 使用完类型后，必须直接或间接释放它。 若要直接释放类型，请在 try/catch 块中调用其 Dispose 方法。 若要间接释放类型，请使用 using（在 C# 中）或 Using（在 Visual Basic 中）等语言构造。 有关详细信息，请参阅 IDisposable 接口主题中的“使用实现 IDisposable 的对象”一节。

事件侦听器可以使用事件级别 () 和事件关键字 EventKeywords (EventLevel) 来进一步限制要发送到侦听器的事件集，从而根据当前事件源启用或禁用事件。 侦听器还可以使用 SendCommand 方法将任意命令发送到特定的当前事件源。 命令的含义特定于事件源的实现。

可以在单个应用程序域中定义多个事件侦听器。 每个侦听器在逻辑上独立于其他侦听器，因此由一个侦听器启用或禁用的事件仅影响该侦听器。 使用 SendCommand 方法发送的命令可以 (执行语义操作，例如垃圾回收或刷新影响其他侦听器的数据) ，但这是例外，而不是规则。

每个事件源保留事件发送到的事件侦听器列表。 一组筛选条件与每个事件源侦听器对相关联。 这些条件确定侦听器将为当前事件源接收的事件。 侦听器在其 OnEventWritten 方法上接收事件。 因此，的 EventListener 子类必须重写此方法才能对数据执行一些有用的操作。

创建新的事件源时， OnEventSourceCreated 将调用 方法。 每个当前事件侦听器只为可以向其发送日志消息的每个当前事件源获取一次 OnEventSourceCreated 调用。 创建事件侦听器时，将进行一系列 OnEventSourceCreated 调用，以通知新侦听器创建侦听器之前存在的所有事件源。

重要

实例化 时EventListener，对 和 OnEventWritten 的OnEventSourceCreated回调可以在构造函数完成之前发生。 初始化这些回调中使用的实例成员时要小心。

构造函数

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 对象）写入时发生，其中事件侦听器已为该事件源启用了事件。