EventListener Osztály

Definíció

Névtér:

System.Diagnostics.Tracing

Szerelvények:

netstandard.dll, System.Diagnostics.Tracing.dll

Forrás:

EventSource.cs

Metódusokat biztosít az események eseményforrásból való engedélyezéséhez és letiltására.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Öröklődés

Object

EventListener

Megvalósítás

IDisposable

Megjegyzések

Az eseményfigyelő az aktuális alkalmazástartomány eseményforrási (EventSource objektum)-implementációi által létrehozott összes esemény célját jelöli. Új eseményfigyelő létrehozásakor logikailag az adott alkalmazástartomány összes eseményforrásához csatlakozik.

Note

Ez a típus implementálja a IDisposable felületet. Ha befejezte a típus használatát, közvetlenül vagy közvetve kell megsemmisítenie. A típus közvetlen ártalmatlanításához hívja meg a Dispose metódust egy try/catch blokkban. Ha közvetve szeretné megsemmisíteni, használjon olyan nyelvi szerkezetet, mint a using (C#-ban) vagy Using (a Visual Basicben). További információ: "Az IDisposable-t megvalósító objektum használata" című szakasz a IDisposable felület témakörében.

Az eseményfigyelők az eseményszintek (EventLevel) és az eseményszavak (EventKeywords) használatával engedélyezhetik vagy tilthatják le az aktuális eseményforrás alapján, hogy tovább korlátozzák a figyelőnek küldendő események készletét. A figyelő tetszőleges parancsokat is küldhet egy adott aktuális eseményforrásnak a SendCommand metódus használatával. A parancsok jelentése az eseményforrás megvalósítására vonatkozik.

Egyetlen alkalmazástartományban több eseményfigyelő is definiálható. Minden figyelő logikailag független a többi figyelővel, így az egyik figyelő által engedélyezett vagy letiltott események csak az adott figyelőre vannak hatással. Lehetséges, hogy a SendCommand metódussal küldött parancsok szemantikai műveletet hajtanak végre (például szemétgyűjtést vagy adatöblítést), amely hatással van a többi figyelőre, de ez a szabály helyett ez a kivétel.

Minden eseményforrás megőrzi azoknak az eseményfigyelőknek a listáját, amelyeknek az eseményeket küldi. Az egyes eseményforrás-figyelő párokhoz szűrési feltételek tartoznak. Ezek a feltételek határozzák meg, hogy a figyelő milyen eseményeket kap az aktuális eseményforráshoz. A figyelők a metódusuk alapján fogadják OnEventWritten az eseményeket. Ezért a metódus alosztályainak EventListener felül kell bírálnia ezt a módszert, hogy valami hasznosat tegyenek az adatokkal.

Új eseményforrás létrehozásakor a rendszer meghívja a OnEventSourceCreated metódust. Minden aktuális eseményfigyelő pontosan egy OnEventSourceCreated hívást kap minden aktuális eseményforráshoz, amely képes naplóüzeneteket küldeni. Eseményfigyelő létrehozásakor a rendszer hívássorozatot OnEventSourceCreated indít, amely értesíti az új figyelőt az összes olyan eseményforrásról, amely a figyelő létrehozása előtt létezett.

Important

A példányosításkor EventListenera visszahívások a konstruktor OnEventSourceCreated befejeződése OnEventWritten következhetnek be és következhetnek be. Ügyeljen arra, hogy a visszahívásokban használt példánytagokat inicializálja.

Konstruktorok

Name	Description
EventListener()	Létrehozza az osztály új példányát EventListener .

Metódusok

Name	Description
DisableEvents(EventSource)	Letiltja a megadott eseményforrás összes eseményét.
Dispose()	Felszabadítja az osztály aktuális példánya EventListener által használt erőforrásokat.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Engedélyezi a megadott eseményforráshoz tartozó eseményeket, amelyeknél a megadott részletességi szint vagy alacsonyabb, az egyező esemény kulcsszójelzője és az egyező argumentumok vannak megadva.
EnableEvents(EventSource, EventLevel, EventKeywords)	Engedélyezi a megadott eseményforráshoz tartozó eseményeket, amelyeknél a megadott részletességi szint vagy alacsonyabb, valamint egyező kulcsszójelölők vannak.
EnableEvents(EventSource, EventLevel)	A megadott részletességi szinttel vagy alacsonyabb szintű eseményforráshoz engedélyezi az eseményeket.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
EventSourceIndex(EventSource)	Egy kis, nem negatív számot kap, amely a megadott eseményforrást jelöli.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnEventSourceCreated(EventSource)	Az eseményfigyelő létrehozásakor és az új eseményforrás figyelőhöz való csatlakoztatásakor az összes meglévő eseményforrásra meghívva.
OnEventWritten(EventWrittenEventArgs)	Akkor hívható meg, ha egy eseményforrás olyan eseményt írt, amelyhez az eseményfigyelő engedélyezte az eseményeket.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

esemény

Name	Description
EventSourceCreated	Akkor fordul elő, ha egy eseményforrás (EventSource objektum) csatlakozik a diszpécserhez.
EventWritten	Akkor fordul elő, ha egy eseményt olyan eseményforrás (EventSource objektum) írt, amelyhez az eseményfigyelő engedélyezte az eseményeket.