EventListener Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет методы для включения и отключения событий из источников событий.
public ref class EventListener abstract : IDisposablepublic ref class EventListener : IDisposablepublic abstract class EventListener : IDisposablepublic class EventListener : IDisposabletype EventListener = class
interface IDisposablePublic MustInherit Class EventListener
Implements IDisposablePublic Class EventListener
Implements IDisposable- Наследование
-
EventListener
- Реализации
Комментарии
Прослушиватель событий представляет целевой объект для всех событий, созданных реализациями источника событий (EventSource объекта) в текущем домене приложения. При создании нового прослушивателя событий он логически присоединяется ко всем источникам событий в этом домене приложения.
Примечание
Этот тип реализует интерфейс IDisposable. Завершив использование типа, его необходимо удалить прямо или косвенно. Чтобы сделать это прямо, вызовите его метод Dispose в блоке try/catch. Чтобы сделать это косвенно, используйте языковые конструкции, такие как using (в C#) или Using (в Visual Basic). Дополнительные сведения см. в разделе "Использование объекта, реализующего IDisposable" в статье об интерфейсе IDisposable.
Прослушиватель событий может включать или отключать для каждого текущего источника событий, используя уровни событий (EventLevel) и ключевые слова событий (EventKeywords), чтобы дополнительно ограничить набор событий, отправляемых прослушивателю. Прослушиватель также может отправлять произвольные команды в конкретный текущий источник событий с помощью 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), для которого прослушиватель события включил события. |
