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.