EventWrittenEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données pour le OnEventWritten(EventWrittenEventArgs) rappel.
public ref class EventWrittenEventArgs : EventArgs
public class EventWrittenEventArgs : EventArgs
type EventWrittenEventArgs = class
inherit EventArgs
Public Class EventWrittenEventArgs
Inherits EventArgs
- Héritage
Remarques
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. Il est transmis une instance EventWrittenEventArgs 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 .
Propriété ActivityId
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.
Propriété de RelatedActivityId
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é, le RelatedActivityID soit passée explicitement par la méthode effectuant la journalisation. De nombreux événements ne passent pas un RelatedActivityId, auquel cas cette propriété retourne Guid.Empty.
Propriétés
| Nom | Description |
|---|---|
| ActivityId |
Obtient l’ID d’activité sur le thread dans lequel l’événement a été écrit. |
| Channel |
Obtient le canal de l’événement. |
| EventId |
Obtient l’identificateur d’événement. |
| EventName |
Obtient le nom de l’événement. |
| EventSource |
Obtient l’objet source d’événement. |
| Keywords |
Obtient les mots clés de l’événement. |
| Level |
Obtient le niveau de l’événement. |
| Message |
Obtient le message de l’événement. |
| Opcode |
Obtient le code d’opération de l’événement. |
| OSThreadId |
Obtient l’identificateur de thread pour le thread de système d’exploitation qui a écrit l’événement. (.NET Core 2.2 et versions ultérieures uniquement.) |
| Payload |
Obtient la charge utile de l’événement. |
| PayloadNames |
Retourne une liste de chaînes qui représentent les noms de propriété de l’événement. |
| RelatedActivityId |
Obtient l’identificateur d’une activité liée à l’activité représentée par l’instance actuelle. |
| Tags |
Retourne les balises spécifiées dans l’appel à la Write(String, EventSourceOptions) méthode. |
| Task |
Obtient la tâche de l’événement. |
| TimeStamp |
Obtient l’heure à laquelle l’événement a été généré à l’origine en tant qu’horodatage DateTime . (.NET Core 2.2 et versions ultérieures uniquement.) |
| Version |
Obtient la version de l’événement. |
Méthodes
| Nom | Description |
|---|---|
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |