EventListener Класс

Определение

Пространство имен:

System.Diagnostics.Tracing

Сборка:

System.Diagnostics.Tracing.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Предоставляет методы для включения и отключения событий из источников событий.

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. Завершив использование типа, его необходимо удалить напрямую или косвенно. Чтобы сделать это прямо, вызовите его метод Dispose в блоке try/catch. Чтобы сделать это косвенно, используйте языковые конструкции, такие как using (в C#) или Using (в Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в статье об интерфейсе IDisposable.

Прослушиватель событий может включать или отключать для каждого источника событий, используя уровни событий (EventLevel) и ключевые слова событий (EventKeywords), чтобы дополнительно ограничить набор событий, отправляемых прослушивателю. Прослушиватель также может отправлять произвольные команды в конкретный источник текущего события с помощью SendCommand метода. Значения команд зависят от реализации источника событий.

Несколько прослушивателей событий можно определить в одном домене приложения. Каждый прослушиватель логически не зависит от других прослушивателей, чтобы события, включенные или отключенные одним прослушивателем, влияли только на этот прослушиватель. Команды, отправленные с SendCommand помощью метода, могут выполнять семантику операции (например, сборку мусора или очистку данных), которая влияет на другие прослушиватели, но это исключение, а не правило.

Каждый источник событий хранит список прослушивателей событий, в которые он отправляет события. Набор критериев фильтрации связан с каждой парой источника событий и прослушивателя. Эти критерии определяют события, которые прослушиватель будет получать для текущего источника событий. Прослушиватели получают события в их OnEventWritten методе. Таким образом, подклассы EventListener должны переопределить этот метод, чтобы сделать что-то полезное с данными.

При создании OnEventSourceCreated нового источника событий вызывается метод. Каждый текущий прослушиватель событий получает ровно один OnEventSourceCreated вызов для каждого текущего источника событий, который может отправлять сообщения журнала. При создании прослушивателя событий выполняется ряд вызовов OnEventSourceCreated для уведомления нового прослушивателя обо всех источниках событий, существовавших до создания прослушивателя.

Важно!

При создании экземпляра EventListener, обратный OnEventSourceCreated вызов и 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), для которого прослушиватель события включил события.