System.Diagnostics.Tracing.EventWrittenEventArgs-Klasse

Dieser Artikel enthält ergänzende Hinweise zur Referenzdokumentation für diese API.

Die EventWrittenEventArgs Klasse stellt Daten für den OnEventWritten Rückruf bereit.

Wenn ein Ereignis an ein EventListener gesendet wird, wird die EventListener.OnEventWritten-Rückrufmethode aufgerufen. Es wird eine EventWrittenEventArgs Instanz übergeben, die Informationen enthält, die dem Ereignis zugeordnet sind. Alle Eigenschaftswerte der Klasse sind nur während des EventWrittenEventArgs Rückrufs gültig.

Die folgenden Abschnitte enthalten zusätzliche Informationen zu einzelnen EventWrittenEventArgs Eigenschaften.

Aktivitäts-ID-Eigenschaft

Bei Verwendung von System.Activities.Activity und den abgeleiteten Klassen können Threads als mit einer Aktivität verbunden gekennzeichnet werden. Die ActivityId Eigenschaft gibt die Aktivitäts-ID des Threads zurück, der das Ereignis protokolliert hat. Beachten Sie, dass Threads keine Aktivität aufweisen müssen, in diesem Fall gibt diese Eigenschaft zurück Guid.Empty.

OSThreadId- und TimeStamp-Eigenschaften

Ab .NET Core 2.2 EventListener können Objekte systemeigene Laufzeitereignisse (z. B. GC-, JIT- und Threadpoolereignisse) zusätzlich zu Ereignissen abonnieren, die von EventSource Objekten ausgegeben werden. In früheren Versionen von .NET Core und allen Versionen von .NET Framework kann die Thread-ID und der Zeitstempel aus der Umgebung gesammelt werden, da sie synchron auf demselben Thread verteilt werden, der sie ausgegeben hat. Nicht alle systemeigenen Laufzeitereignisse können synchron verteilt werden. Einige Ereignisse, z. B. GC-Ereignisse, werden ausgegeben, wenn die Ausführung des verwalteten Threads angehalten wird. Diese Ereignisse werden in systemeigenem Code gepuffert und von einem Dispatcherthread verteilt, sobald verwalteter Code erneut ausgeführt werden kann. Da diese Ereignisse gepuffert sind, kann die Umgebung nicht verwendet werden, um die Thread-ID und den Zeitstempel zuverlässig abzurufen. Aus diesem Grund sind thread-ID- und Zeitstempelinformationen ab .NET Core 2.2 als Member der EventWrittenEventArgs Klasse verfügbar.

RelatedActivityId-Eigenschaft

Eine verwandte Aktivität ist eine Aktivität, die stark mit dem aktuellen verknüpft ist. In der Regel handelt es sich entweder um die Aktivität, die die aktuelle Aktivität verursacht hat (Ereignisse mit dem Start-Opcode tun dies normalerweise) oder um eine Aktivität, die von der aktuellen erstellt wurde (Ereignisse mit dem Send-Opcode tun dies normalerweise). Wenn es verwendet wird, wird das RelatedActivityID explizit von der Methode, die das Logging ausführt, übergeben. Übergeben Sie nicht viele Ereignisse eine RelatedActivityId, in diesem Fall gibt diese Eigenschaft zurück Guid.Empty.