EventListener Klasa

Definicja

Przestrzeń nazw:

System.Diagnostics.Tracing

Zestaw:

System.Diagnostics.Tracing.dll

Źródło:

EventSource.cs

Udostępnia metody włączania i wyłączania zdarzeń ze źródeł zdarzeń.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Dziedziczenie

Object

EventListener

Implementuje

IDisposable

Uwagi

Odbiornik zdarzeń reprezentuje element docelowy dla wszystkich zdarzeń generowanych przez implementacje źródła zdarzeń (EventSource obiektu) w bieżącej domenie aplikacji. Po utworzeniu nowego odbiornika zdarzeń jest on logicznie dołączany do wszystkich źródeł zdarzeń w tej domenie aplikacji.

Uwaga

Ten typ implementuje IDisposable interfejs. Po zakończeniu korzystania z typu należy usunąć go bezpośrednio lub pośrednio. Aby bezpośrednio usunąć typ, wywołaj jego Dispose metodę try/catch w bloku. Aby usunąć go pośrednio, użyj konstrukcji języka, takiej jak using (w języku C#) lub Using (w Visual Basic). Aby uzyskać więcej informacji, zobacz sekcję "Using an Object that Implements IDisposable" (Używanie obiektu implementujące interfejs IDisposable) w temacie interfejsu IDisposable .

Odbiornik zdarzeń może włączać lub wyłączać dla bieżącego źródła zdarzeń przy użyciu poziomów zdarzeń (EventLevel) i słów kluczowych zdarzeń (EventKeywords), aby dodatkowo ograniczyć zestaw zdarzeń do wysłania do odbiornika. Odbiornik może również wysyłać dowolne polecenia do określonego bieżącego źródła zdarzeń przy użyciu SendCommand metody . Znaczenie poleceń jest specyficzne dla implementacji źródła zdarzeń.

W jednej domenie aplikacji można zdefiniować wiele odbiorników zdarzeń. Każdy odbiornik jest logicznie niezależny od innych odbiorników, dzięki czemu zdarzenia, które są włączone lub wyłączone przez jeden odbiornik, mają wpływ tylko na ten odbiornik. Istnieje możliwość wysyłania poleceń za pomocą SendCommand metody w celu wykonania operacji semantycznej (takiej jak odzyskiwanie pamięci lub opróżnianie danych), które mają wpływ na inne odbiorniki, ale jest to wyjątek, a nie reguła.

Każde źródło zdarzeń przechowuje listę odbiorników zdarzeń, do których wysyła zdarzenia. Zestaw kryteriów filtrowania jest skojarzony z każdą parą odbiornika źródła zdarzeń. Te kryteria określają zdarzenia odbierane przez odbiornik dla bieżącego źródła zdarzeń. Odbiorniki odbierają zdarzenia w ich OnEventWritten metodzie. W związku z EventListener tym podklasy elementu muszą zastąpić tę metodę, aby wykonać coś przydatnego w przypadku danych.

Po utworzeniu nowego źródła zdarzeń wywoływana OnEventSourceCreated jest metoda . Każdy bieżący odbiornik zdarzeń otrzymuje dokładnie jedno OnEventSourceCreated wywołanie dla każdego bieżącego źródła zdarzeń, które może wysyłać komunikaty dziennika. Po utworzeniu odbiornika zdarzeń są wykonywane serie wywołań OnEventSourceCreated w celu powiadomienia nowego odbiornika wszystkich źródeł zdarzeń, które istniały przed utworzeniem odbiornika.

Ważne

Podczas tworzenia wystąpienia metody wywołania zwrotnego EventListenerOnEventSourceCreated do metody i OnEventWritten może wystąpić przed ukończeniem konstruktora. Podczas inicjowania elementów członkowskich wystąpień używanych w tych wywołaniach zwrotnych należy zachować ostrożność.

Konstruktory

EventListener()

Tworzy nowe wystąpienie klasy EventListener.

Metody

DisableEvents(EventSource)	Wyłącza wszystkie zdarzenia dla określonego źródła zdarzeń.
Dispose()	Zwalnia zasoby używane przez bieżące wystąpienie klasy EventListener.
EnableEvents(EventSource, EventLevel)	Włącza zdarzenia dla określonego źródła zdarzeń, które ma określony poziom szczegółowości lub niższy.
EnableEvents(EventSource, EventLevel, EventKeywords)	Włącza zdarzenia dla określonego źródła zdarzeń, które ma określony poziom szczegółowości lub niższy oraz pasujące flagi słowa kluczowego.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Włącza zdarzenia dla określonego źródła zdarzeń, które ma określony poziom szczegółowości lub niższy, pasujące flagi słowa kluczowego zdarzenia i pasujące argumenty.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
EventSourceIndex(EventSource)	Pobiera małą liczbę nieujemną, która reprezentuje określone źródło zdarzeń.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnEventSourceCreated(EventSource)	Wywoływane dla wszystkich istniejących źródeł zdarzeń po utworzeniu odbiornika zdarzeń i dołączeniu nowego źródła zdarzeń do odbiornika.
OnEventWritten(EventWrittenEventArgs)	Wywoływane za każdym razem, gdy zdarzenie zostało zapisane przez źródło zdarzeń, dla którego odbiornik zdarzeń włączył zdarzenia.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

EventSourceCreated	Występuje, gdy źródło zdarzeń (EventSource obiekt) jest dołączone do dyspozytora.
EventWritten	Występuje, gdy zdarzenie zostało zapisane przez źródło zdarzeń (EventSource obiekt), dla którego odbiornik zdarzeń włączył zdarzenia.