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.

Jedes Mal, wenn ein Ereignis an verteilt ist ein EventListener, EventListener.OnEventWritten Callback-Methode aufgerufen wird. Übergabe einer EventWrittenEventArgs -Instanz, die dem Ereignis zugeordnete Informationen enthält. Alle Eigenschaftswerte der EventWrittenEventArgs Klasse gültig sind, nur während des Rückrufs.

Die folgenden Abschnitte enthalten weitere Informationen zu einzelnen EventWrittenEventArgs Eigenschaften.

Aktivitäts-ID-Eigenschaft

Bei Verwendung System.Activities.Activity und davon abgeleiteten Klassen, die Threads können mit einer zugehörigen Aktivität markiert werden. Die ActivityId Eigenschaft gibt die Aktivitäts-ID des Threads, der das Ereignis protokolliert. Beachten Sie, dass Threads nicht unbedingt müssen eine Aktivität, in diesem Fall diese Eigenschaft gibt Guid.Empty.

OSThreadId und TimeStamp-Eigenschaften

Beginnend mit .NET Core 2.2 EventListener Objekte können native-Runtime-Ereignisse (z. B. JIT-Kompilierung, GC und Threadpool-Ereignisse) zusätzlich zum Ereignisse ausgegeben werden abonnieren EventSource Objekte. 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 native-Runtime-Ereignisse können jedoch synchron verteilt werden. Einige Ereignisse, z. B. GC-Ereignisse werden ausgegeben, wenn verwaltete die Threadausführung wird angehalten. Diese Ereignisse, die in nativem Code gepuffert werden und werden durch einen Dispatcher-Thread verteilt, sobald der verwaltete Code erneut ausführen können. Da diese Ereignisse gepuffert werden, kann nicht die Umgebung verwendet werden, um den Thread-ID und den Zeitstempel zuverlässig abzurufen. Aus diesem Grund beginnend mit .NET Core 2.2, thread-ID und Timestampinformationen finden Sie als Mitglied der EventWrittenEventArgs Klasse.

RelatedActivityId-Eigenschaft

Eine verwandte Aktivität ist eine Aktivität, die stark mit der aktuellen Aktivität verknüpft ist. Normalerweise ist entweder der Aktivität, die die aktuelle Aktivität verursacht hat (Ereignisse mit der Start Opcode in der Regel dazu) oder eine Aktivität, die die aktuelle Anwendung erstellt wurde (Ereignisse mit der Send Opcode in der Regel dazu). Wenn sie verwendet wird, die RelatedActivityID explizit übergeben wird, von der Methode, die die Protokollierung durchführen. Übergeben Sie nicht viele Ereignisse eine RelatedActivityId, in diesem Fall gibt diese Eigenschaft zurück Guid.Empty.