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