EventListener 类

定义

提供用于启用和禁用事件源中事件的方法。

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

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

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

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

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

重要

实例化时EventListenerOnEventSourceCreated在构造函数完成 之前,回调可以OnEventWritten发生。 初始化这些回调中使用的实例成员时,请小心。

构造函数

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

适用于