EventListener Třída

Definice

Obor názvů:

System.Diagnostics.Tracing

Sestavení:

netstandard.dll, 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álosti 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 této doméně aplikace.

Note

Tento typ implementuje rozhraní IDisposable. Jakmile typ dokončíte, musíte ho odstranit buď přímo, nebo nepřímo. Chcete-li typ odstranit přímo, zavolejte jeho Dispose metodu v bloku try/catch. Pokud ho chcete zlikvidovat nepřímo, použijte konstruktor jazyka, jako je using (v jazyce C#) nebo Using (v jazyce Visual Basic). Další informace naleznete 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ě jednotlivých aktuálních zdrojů událostí pomocí úrovní událostí (EventLevel) a klíčových slov událostí () aEventKeywords dále omezit sadu 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í SendCommand metody. Významy příkazů jsou 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 procesech, aby události povolené nebo zakázané jedním naslouchacím procesem ovlivnily pouze tento naslouchací proces. Příkazy odeslané metodou SendCommand je možné provést sémantickou operaci (například uvolňování paměti nebo vyprázdnění dat), které ovlivňují ostatní naslouchací procesy, ale toto je výjimka místo pravidla.

Každý zdroj událostí uchovává seznam naslouchacích procesů událostí, kterým odesílá události. Sada kritérií filtrování je přidružena ke každému páru naslouchacího procesu zdroje událostí. Tato kritéria určují události, které naslouchací proces obdrží pro aktuální zdroj událostí. Naslouchací procesy přijímají události ve své OnEventWritten metodě. Proto podtřídy musí tuto metodu EventListener přepsat, aby se s daty něco užitečného.

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

Important

Při vytváření EventListenerinstance zpětného 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 je potřeba věnovat pozornost.

Konstruktory

Name	Description
EventListener()	Vytvoří novou instanci EventListener třídy.

Metody

Name	Description
DisableEvents(EventSource)	Zakáže všechny události pro zadaný zdroj událostí.
Dispose()	Uvolní prostředky používané aktuální instancí EventListener třídy.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Povolí události pro zadaný zdroj událostí, který má zadanou úroveň podrobností nebo nižší, odpovídající příznak klíčového slova události a odpovídající argumenty.
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)	Povolí události pro zadaný zdroj událostí, který má zadanou úroveň podrobností nebo nižší.
Equals(Object)	Určuje, zda je zadaný objekt roven 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í funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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 při každém zápisu události zdrojem 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

Name	Description
EventSourceCreated	Nastane, když je zdroj události (EventSource objekt) připojen k dispečeru.
EventWritten	Nastane, když událost byla zapsána zdrojem události (EventSource objekt), pro který naslouchací proces událostí povolil události.