Classe System.Diagnostics.Tracing.EventWrittenEventArgs

Cet article fournit des remarques supplémentaires à la documentation de référence de cette API.

La EventWrittenEventArgs classe fournit des données pour le OnEventWritten rappel.

Chaque fois qu’un événement est distribué à un EventListener, la EventListener.OnEventWritten méthode de rappel est appelée. Elle est passée à une EventWrittenEventArgs instance qui contient des informations associées à l’événement. Toutes les valeurs de propriété de la EventWrittenEventArgs classe sont valides uniquement pendant le rappel.

Les sections suivantes contiennent des informations supplémentaires sur les propriétés individuelles EventWrittenEventArgs .

ActivityId, propriété

Lors de l’utilisation System.Activities.Activity et de ses classes dérivées, les threads peuvent être marqués comme ayant une activité associée. La ActivityId propriété retourne l’ID d’activité du thread qui a enregistré l’événement. Notez que les threads n’ont pas besoin d’avoir une activité, auquel cas cette propriété retourne Guid.Empty.

Propriétés OSThreadId et TimeStamp

À compter de .NET Core 2.2, EventListener les objets peuvent s’abonner à des événements d’exécution natifs (tels que GC, JIT et événements threadpool) en plus des événements émis par EventSource des objets. Dans les versions précédentes de .NET Core et toutes les versions de .NET Framework, l’ID de thread et l’horodatage peuvent être collectés à partir de l’environnement, car ils sont distribués de manière synchrone sur le même thread que celui qui les a émis. Toutefois, tous les événements d’exécution natifs ne peuvent pas être distribués de manière synchrone. Certains événements, tels que les événements GC, sont émis lorsque l’exécution du thread managé est suspendue. Ces événements sont mis en mémoire tampon dans le code natif et sont distribués par un thread de répartiteur une fois que le code managé peut s’exécuter à nouveau. Étant donné que ces événements sont mis en mémoire tampon, l’environnement ne peut pas être utilisé pour récupérer de manière fiable l’ID de thread et l’horodatage. En raison de cela, à partir de .NET Core 2.2, les informations d’ID de thread et d’horodatage sont disponibles en tant que membres de la EventWrittenEventArgs classe.

RelatedActivityId, propriété

Une activité associée est une activité fortement liée à l’activité actuelle. En règle générale, il s’agit de l’activité à l’origine de l’activité actuelle (les événements avec l’opcode Start le font généralement) ou d’une activité qui a été créée par l’activité actuelle (les événements avec opcode Send le font généralement). Lorsqu’il est utilisé, il RelatedActivityID est explicitement passé par la méthode qui effectue la journalisation. De nombreux événements ne passent pas un RelatedActivityId, auquel cas cette propriété retourne Guid.Empty.