EventListener 类

定义

命名空间:
System.Diagnostics.Tracing
程序集:
mscorlib.dll, System.Diagnostics.Tracing.dll
程序集:
netstandard.dll, System.Diagnostics.Tracing.dll
程序集:
System.Diagnostics.Tracing.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll
Source:
EventSource.cs
Source:
EventListener.cs
Source:
EventSource.cs
Source:
EventSource.cs
Source:
EventSource.cs

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

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
继承
Object
EventListener
实现
IDisposable

注解

事件侦听器表示当前应用程序域中事件源（EventSource 对象）实现生成的所有事件的目标。 创建新的事件侦听器时，它会在逻辑上附加到该应用程序域中的所有事件源。

注释

此类型实现 IDisposable 接口。 使用完该类型后，必须直接或间接释放它。 若要直接释放类型，请在块中Disposetry/调用其catch方法。 若要间接释放它，请使用语言构造，例如 using （在 C# 中）或 Using （在 Visual Basic 中）。 有关详细信息，请参阅接口主题中的 IDisposable “使用实现 IDisposable 的对象”部分。

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

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

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

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

Important

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

构造函数

名称 说明
EventListener()

创建类的新实例 EventListener 。

方法

名称 说明
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)

活动

名称 说明
EventSourceCreated

当事件源（EventSource 对象）附加到调度程序时发生。
EventWritten

当事件由事件侦听器为其启用了事件的事件源（EventSource 对象）写入时发生。

适用于