EventWrittenEventArgs Classe

Definizione

public ref class EventWrittenEventArgs : EventArgs

public class EventWrittenEventArgs : EventArgs

type EventWrittenEventArgs = class
    inherit EventArgs

Public Class EventWrittenEventArgs
Inherits EventArgs

Ereditarietà

Object

EventArgs

EventWrittenEventArgs

Commenti

La EventWrittenEventArgs classe fornisce dati per il OnEventWritten callback.

Ogni volta che un evento viene inviato a un EventListeneroggetto, il metodo di callback EventListener.OnEventWritten viene richiamato. Viene fornita un'istanza EventWrittenEventArgs che contiene informazioni associate all'evento. Tutti i valori delle proprietà della EventWrittenEventArgs classe sono validi solo durante il callback.

Le sezioni seguenti contengono informazioni aggiuntive sulle singole EventWrittenEventArgs proprietà.

ActivityId - proprietà

Quando si usano System.Activities.Activity e le relative classi derivate, i thread possono essere contrassegnati come associati a un'attività. La ActivityId proprietà restituisce l'ID attività del thread che ha registrato l'evento. Si noti che i thread non devono avere un'attività, nel qual caso questa proprietà restituisce Guid.Empty.

Proprietà OSThreadId e TimeStamp

A partire da .NET Core 2.2, EventListener gli oggetti possono sottoscrivere eventi di runtime nativi (ad esempio eventi GC, JIT e threadpool) oltre agli eventi generati dagli EventSource oggetti . Nelle versioni precedenti di .NET Core e di tutte le versioni di .NET Framework, l'ID del thread e il timestamp possono essere raccolti dall'ambiente, perché vengono inviati in modo sincrono nello stesso thread che li ha generati. Non tutti gli eventi di runtime nativi possono tuttavia essere inviati in modo sincrono. Alcuni eventi, ad esempio gli eventi GC, vengono generati quando l'esecuzione del thread gestito viene sospesa. Questi eventi vengono memorizzati nel buffer nel codice nativo e vengono inviati da un thread dispatcher una volta che il codice gestito può essere eseguito di nuovo. Poiché questi eventi vengono memorizzati nel buffer, l'ambiente non può essere usato per recuperare in modo affidabile l'ID del thread e il timestamp. Per questo motivo, a partire da .NET Core 2.2, le informazioni sull'ID del thread e sul timestamp sono disponibili come membri della EventWrittenEventArgs classe .

RelatedActivityId - proprietà

Un'attività correlata è un'attività strettamente correlata a quella corrente. In genere, è l'attività che ha causato l'attività corrente (eventi con il Start codice operativo in genere eseguire questa operazione) o un'attività creata da quella corrente (eventi con il Send codice operativo in genere eseguire questa operazione). Quando viene usato, l'oggetto RelatedActivityID viene passato in modo esplicito dal metodo che esegue la registrazione. Molti eventi non superano un RelatedActivityId, in tal caso questa proprietà restituisce Guid.Empty.