System.Diagnostics.Tracing.EventWrittenEventArgs osztály
Ez a cikk kiegészítő megjegyzéseket tartalmaz az API referenciadokumentációjához.
Az EventWrittenEventArgs osztály adatokat biztosít a OnEventWritten visszahíváshoz.
Amikor egy eseményt küldenek egy EventListenereseménynek, a rendszer meghívja a EventListener.OnEventWritten visszahívási módszert. A rendszer átad egy olyan példányt EventWrittenEventArgs
, amely az eseményhez társított információkat tartalmazza. Az osztály összes tulajdonságértéke EventWrittenEventArgs
csak a visszahívás során érvényes.
A következő szakaszok további információkat tartalmaznak az egyes EventWrittenEventArgs
tulajdonságokról.
ActivityId tulajdonság
A használatukkor System.Activities.Activity és a származtatott osztályaikkal a szálakat úgy lehet megjelölni, hogy tevékenység van hozzájuk társítva. A ActivityId
tulajdonság az eseményt naplózó szál tevékenységazonosítóját adja vissza. Vegye figyelembe, hogy a szálaknak nem kell tevékenységekkel rendelkezniük, ebben az esetben ez a tulajdonság ad vissza Guid.Empty.
OSThreadId és TimeStamp tulajdonságok
A .NET Core 2.2-től EventListener kezdve az objektumok az objektumok által EventSource kibocsátott események mellett natív futtatókörnyezeti eseményekre (például GC, JIT és threadpooleseményekre) is feliratkozhatnak. A .NET Core korábbi verzióiban és a .NET-keretrendszer összes verziójában a szálazonosító és az időbélyeg összegyűjthető a környezetből, mivel a rendszer szinkron módon küldi el őket ugyanazon a szálon, amely azokat kibocsátotta. Azonban nem minden natív futtatókörnyezeti esemény küldhető szinkronban. Bizonyos események, például a GC-események, a felügyelt szálvégrehajtás felfüggesztésekor lesznek kibocsátva. Ezeket az eseményeket a rendszer natív kódban puffereli, és egy diszpécserszál küldi el őket, miután a felügyelt kód újra végrehajtható. Mivel ezek az események pufferelve vannak, a környezet nem használható a szálazonosító és az időbélyeg megbízható lekérésére. Emiatt a .NET Core 2.2-től kezdve a szálazonosító és az időbélyeg adatai az EventWrittenEventArgs
osztály tagjaiként érhetők el.
RelatedActivityId tulajdonság
A kapcsolódó tevékenység olyan tevékenység, amely erősen kapcsolódik az aktuális tevékenységhez. Általában az aktuális tevékenységet okozó tevékenység (az Start
opcode-ot tartalmazó események általában ezt teszik), vagy az aktuális által létrehozott tevékenység (az Send
opcode-ot tartalmazó események általában ezt teszik). A használat során a RelatedActivityID
naplózást végző metódus kifejezetten átadja a metódusnak. Sok esemény nem ad át egy RelatedActivityId
értéket , ebben az esetben ez a tulajdonság ad vissza Guid.Empty.