EventListener Třída

Definice

Obor názvů:

System.Diagnostics.Tracing

Sestavení:

System.Diagnostics.Tracing.dll

Zdroj:

EventSource.cs

Poskytuje metody pro povolení a zakázání událostí ze zdrojů událostí.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Dědičnost

Object

EventListener

Implementuje

IDisposable

Poznámky

Naslouchací proces událostí představuje cíl pro všechny události generované implementacemi zdroje událostí (EventSource objektu) v aktuální doméně aplikace. Při vytvoření nového naslouchacího procesu událostí je logicky připojen ke všem zdrojům událostí v dané doméně aplikace.

Poznámka

Tento typ implementuje IDisposable rozhraní . Jakmile dokončíte používání typu, musíte ho odstranit přímo nebo nepřímo. Chcete-li odstranit typ přímo, zavolejte jeho Dispose metodu try/catch v bloku. Pokud ho chcete odstranit nepřímo, použijte konstruktor jazyka, jako using je (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace najdete v části "Použití objektu, který implementuje IDisposable" v IDisposable tématu rozhraní.

Naslouchací proces událostí může povolit nebo zakázat na základě aktuálního zdroje událostí pomocí úrovní událostí (EventLevel) a klíčových slov událostí (EventKeywords), aby se dále omezila sada událostí, které se mají odesílat do naslouchacího procesu. Naslouchací proces může také odesílat libovolné příkazy do konkrétního aktuálního zdroje událostí pomocí metody .SendCommand Význam příkazů je specifický pro implementaci zdroje událostí.

V jedné doméně aplikace je možné definovat více naslouchacích procesů událostí. Každý naslouchací proces je logicky nezávislý na ostatních naslouchacích procesů, takže události povolené nebo zakázané jedním naslouchacím procesem ovlivňují pouze tento naslouchací proces. Příkazy odeslané metodou SendCommand mohou provést sémantickou operaci (například uvolnění paměti nebo vyprázdnění dat), která ovlivňuje ostatní naslouchací procesy, ale toto je výjimka, nikoli pravidlo.

Každý zdroj událostí uchovává seznam naslouchacích procesů událostí, do nichž odesílá události. Ke každé dvojici zdroj-naslouchací proces události je přidružena sada kritérií filtrování. Tato kritéria určují události, které bude naslouchací proces přijímat pro aktuální zdroj událostí. Naslouchací procesy přijímají události u své OnEventWritten metody. Proto musí podtřídy EventListener přepsat tuto metodu, aby s daty udělaly něco užitečného.

Při vytvoření nového zdroje událostí je volána OnEventSourceCreated metoda . Každý naslouchací proces aktuálních událostí obdrží přesně jedno OnEventSourceCreated volání pro každý aktuální zdroj událostí, který mu může odesílat zprávy protokolu. Při vytvoření naslouchacího procesu událostí se provede řada volání, která novému naslouchacímu OnEventSourceCreated procesu oznámí všechny zdroje událostí, které existovaly před vytvořením naslouchacího procesu.

Důležité

Při vytváření EventListenerinstance , zpětné volání do OnEventSourceCreated a OnEventWritten může dojít před dokončením konstruktoru. Při inicializaci členů instance používaných v těchto zpětných voláních dávejte pozor.

Konstruktory

EventListener()

Vytvoří novou instanci třídy EventListener.

Metody

DisableEvents(EventSource)	Zakáže všechny události pro zadaný zdroj událostí.
Dispose()	Uvolní prostředky používané aktuální instancí třídy EventListener.
EnableEvents(EventSource, EventLevel)	Povolí události pro zadaný zdroj událostí, které mají zadanou úroveň podrobností nebo nižší.
EnableEvents(EventSource, EventLevel, EventKeywords)	Povolí události pro zadaný zdroj událostí, který má zadanou úroveň podrobností nebo nižší, a odpovídající příznaky klíčových slov.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Povolí události pro zadaný zdroj událostí, které mají zadanou úroveň podrobností nebo nižší, odpovídající příznak klíčového slova události a odpovídající argumenty.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
EventSourceIndex(EventSource)	Získá malé nezáporné číslo, které představuje zadaný zdroj události.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnEventSourceCreated(EventSource)	Volá se pro všechny existující zdroje událostí při vytvoření naslouchacího procesu událostí a při připojení nového zdroje událostí k naslouchacímu procesu.
OnEventWritten(EventWrittenEventArgs)	Volá se vždy, když zdroj událostí, pro který naslouchací proces událostí povolil události.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

EventSourceCreated	Vyvolá se při připojení zdroje událostí (EventSource objekt) k dispečeru.
EventWritten	Nastane, když událost byla zapsána zdrojem události (EventSource objektem), pro který má naslouchací proces událostí povolené události.