EventListener Klass

Definition

Namnområde:

System.Diagnostics.Tracing

Sammansättningar:

netstandard.dll, System.Diagnostics.Tracing.dll

Källa:

EventSource.cs

Innehåller metoder för att aktivera och inaktivera händelser från händelsekällor.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Arv

Object

EventListener

Implementeringar

IDisposable

Kommentarer

En händelselyssnare representerar målet för alla händelser som genereras av implementeringar av händelsekälla (EventSource objekt) i den aktuella programdomänen. När en ny händelselyssnare skapas är den logiskt kopplad till alla händelsekällor i programdomänen.

Note

Den här typen implementerar IDisposable gränssnittet. När du har använt typen måste du ta bort den direkt eller indirekt. Om du vill ta bort typen direkt anropar du dess Dispose metod i ett try/catch block. Om du vill ta bort det indirekt använder du en språkkonstruktion som using (i C#) eller Using (i Visual Basic). Mer information finns i avsnittet "Använda ett objekt som implementerar IDisposable" i IDisposable gränssnittet.

En händelselyssnare kan aktivera eller inaktivera per aktuell händelsekälla genom att använda händelsenivåer (EventLevel) och händelsenyckelord (EventKeywords) för att ytterligare begränsa den uppsättning händelser som ska skickas till lyssnaren. Lyssnaren kan också skicka godtyckliga kommandon till en specifik aktuell händelsekälla med hjälp SendCommand av metoden . Innebörden av kommandona är specifika för implementeringen av händelsekällan.

Flera händelselyssnare kan definieras i en enda programdomän. Varje lyssnare är logiskt oberoende av de andra lyssnarna så att händelser som aktiveras eller inaktiveras av en lyssnare endast påverkar lyssnaren. Det är möjligt för kommandon som skickas med SendCommand metoden att utföra en semantisk åtgärd (till exempel en skräpinsamling eller tömning av data) som påverkar de andra lyssnarna, men det här är undantaget snarare än regeln.

Varje händelsekälla har en lista över händelselyssnare som den skickar händelser till. En uppsättning filtreringsvillkor associeras med varje händelsekälla-lyssnarpar. Dessa kriterier avgör vilka händelser som lyssnaren ska ta emot för den aktuella händelsekällan. Lyssnarna får händelserna på sin OnEventWritten metod. Därför måste underklasser av EventListener åsidosätta den här metoden för att göra något användbart med data.

När en ny händelsekälla skapas OnEventSourceCreated anropas metoden. Varje aktuell händelselyssnare får exakt ett OnEventSourceCreated anrop för varje aktuell händelsekälla som kan skicka loggmeddelanden. När en händelselyssnare skapas görs en serie OnEventSourceCreated anrop för att meddela den nya lyssnaren om alla händelsekällor som fanns innan lyssnaren skapades.

Important

När du instansierar EventListener en OnEventSourceCreatedkan återanrop till och OnEventWritten ske innan konstruktorn har slutförts. Var försiktig när du initierar instansmedlemmar som används i dessa återanrop.

Konstruktorer

Name	Description
EventListener()	Skapar en ny instans av EventListener klassen.

Metoder

Name	Description
DisableEvents(EventSource)	Inaktiverar alla händelser för den angivna händelsekällan.
Dispose()	Frigör de resurser som används av den aktuella instansen EventListener av klassen.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Aktiverar händelser för den angivna händelsekällan som har den angivna verbositetsnivån eller lägre, matchande händelsenyckelordsflagga och matchande argument.
EnableEvents(EventSource, EventLevel, EventKeywords)	Aktiverar händelser för den angivna händelsekällan som har den angivna verbositetsnivån eller lägre och matchande nyckelordsflaggor.
EnableEvents(EventSource, EventLevel)	Aktiverar händelser för den angivna händelsekällan som har den angivna verbositetsnivån eller lägre.
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
EventSourceIndex(EventSource)	Hämtar ett litet icke-negativt tal som representerar den angivna händelsekällan.
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
OnEventSourceCreated(EventSource)	Anropas för alla befintliga händelsekällor när händelselyssnaren skapas och när en ny händelsekälla är kopplad till lyssnaren.
OnEventWritten(EventWrittenEventArgs)	Anropas när en händelse har skrivits av en händelsekälla som händelselyssnaren har aktiverat händelser för.
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)

Händelser

Name	Description
EventSourceCreated	Inträffar när en händelsekälla (EventSource objekt) är kopplad till avsändaren.
EventWritten	Inträffar när en händelse har skrivits av en händelsekälla (EventSource objekt) som händelselyssnaren har aktiverat händelser för.