Klasse System.Diagnostics.Tracing.EventWrittenEventArgs

In dit artikel vindt u aanvullende opmerkingen in de referentiedocumentatie voor deze API.

De EventWrittenEventArgs klasse biedt gegevens voor de OnEventWritten callback.

Wanneer een gebeurtenis naar een EventListenergebeurtenis wordt verzonden, wordt de EventListener.OnEventWritten callback-methode aangeroepen. Er wordt een EventWrittenEventArgs exemplaar doorgegeven dat informatie bevat die is gekoppeld aan de gebeurtenis. Alle eigenschapswaarden van de EventWrittenEventArgs klasse zijn alleen geldig tijdens de callback.

De volgende secties bevatten aanvullende informatie over afzonderlijke EventWrittenEventArgs eigenschappen.

ActivityId-eigenschap

Wanneer u System.Activities.Activity en de afgeleide klassen ervan gebruikt, kunnen threads worden gemarkeerd als een activiteit die eraan is gekoppeld. De ActivityId eigenschap retourneert de activiteits-id van de thread die de gebeurtenis heeft geregistreerd. Houd er rekening mee dat threads geen activiteit hoeven te hebben. In dat geval retourneert Guid.Emptydeze eigenschap.

Eigenschappen osThreadId en TimeStamp

Vanaf .NET Core 2.2 EventListener kunnen objecten zich abonneren op systeemeigen runtime-gebeurtenissen (zoals GC-, JIT- en threadpool-gebeurtenissen) naast gebeurtenissen die door EventSource objecten worden verzonden. In eerdere versies van .NET Core en alle versies van .NET Framework kan de thread-id en tijdstempel worden verzameld uit de omgeving, omdat ze synchroon worden verzonden op dezelfde thread die ze heeft verzonden. Niet alle systeemeigen runtimegebeurtenissen kunnen echter synchroon worden verzonden. Sommige gebeurtenissen, zoals GC-gebeurtenissen, worden verzonden wanneer de uitvoering van beheerde threads wordt onderbroken. Deze gebeurtenissen worden gebufferd in systeemeigen code en worden verzonden door een dispatcher-thread zodra beheerde code opnieuw kan worden uitgevoerd. Omdat deze gebeurtenissen worden gebufferd, kan de omgeving niet worden gebruikt om de thread-id en tijdstempel betrouwbaar op te halen. Daarom zijn thread-id's en tijdstempelgegevens beschikbaar als leden van de EventWrittenEventArgs klasse, te beginnen met .NET Core 2.2.

Eigenschap RelatedActivityId

Een gerelateerde activiteit is een activiteit die sterk is gerelateerd aan de huidige activiteit. Normaal gesproken is het de activiteit die de huidige activiteit heeft veroorzaakt (gebeurtenissen met de Start opcode doen dit meestal) of een activiteit die is gemaakt door de huidige activiteit (gebeurtenissen met de Send opcode doen dit meestal). Wanneer deze wordt gebruikt, wordt de RelatedActivityID methode die de logboekregistratie uitvoert, expliciet doorgegeven. Veel gebeurtenissen geven geen door, RelatedActivityIdin dat geval retourneert Guid.Emptydeze eigenschap.