System.Diagnostics.Tracing.EventWrittenEventArgs-klass

Klassen EventWrittenEventArgs tillhandahåller data för återanropet OnEventWritten .

När en händelse skickas till en EventListener, anropas återanropsmetoden i EventListener.OnEventWritten. En EventWrittenEventArgs-instans skickas som innehåller information som är associerad med händelsen. Alla egenskapsvärden för EventWrittenEventArgs klassen är endast giltiga under återanropet.

Följande avsnitt innehåller ytterligare information om enskilda EventWrittenEventArgs egenskaper.

ActivityId-egenskapen

När du använder System.Activities.Activity och dess härledda klasser kan trådar markeras som associerade med en aktivitet. Egenskapen ActivityId returnerar aktivitets-ID för tråden som loggade händelsen. Observera att trådar inte behöver ha någon aktivitet, i vilket fall den här egenskapen returnerar Guid.Empty.

OSThreadId- och TimeStamp-egenskaper

Från och med .NET Core 2.2 EventListener kan objekt prenumerera på interna körningshändelser (till exempel GC-, JIT- och threadpool-händelser) utöver händelser som genereras av EventSource objekt. I tidigare versioner av .NET Core och alla versioner av .NET Framework kan tråd-ID och tidsstämpel samlas in från miljön, eftersom de skickas synkront på samma tråd som skickade dem. Alla interna körningshändelser kan dock inte skickas synkront. Vissa händelser, till exempel GC-händelser, genereras när den hanterade trådkörningen pausas. Dessa händelser buffras i den interna koden och kan skickas av en dispatchertråd så snart hanterad kod kan köras igen. Eftersom dessa händelser buffras kan inte miljön användas för att på ett tillförlitligt sätt hämta tråd-ID och tidsstämpel. På grund av detta, från och med .NET Core 2.2, är tråd-ID och tidsstämpelinformation tillgängliga som medlemmar i EventWrittenEventArgs klassen.

Egenskapen RelatedActivityId

En relaterad aktivitet är en aktivitet som är starkt relaterad till den aktuella aktiviteten. Vanligtvis är det antingen aktiviteten som orsakade den aktuella aktiviteten (händelser med Start opcode gör vanligtvis detta) eller en aktivitet som skapades av den aktuella (händelser med Send opcode gör vanligtvis detta). När den används skickas RelatedActivityID explicit av metoden som gör loggningen. Många händelser skickar inte en RelatedActivityId, i vilket fall den här egenskapen returnerar Guid.Empty.