Classe System.Diagnostics.Tracing.EventWrittenEventArgs

Este artigo fornece comentários complementares à documentação de referência para esta API.

A EventWrittenEventArgs classe fornece dados para o OnEventWritten callback.

Sempre que um evento é enviado para um EventListener, o EventListener.OnEventWritten método de retorno de chamada é invocado. Ele é passado por uma EventWrittenEventArgs instância que contém informações associadas ao evento. Todos os valores de propriedade do EventWrittenEventArgs classe são válidos apenas durante o retorno de chamada.

As seções a seguir contêm informações adicionais sobre propriedades individuais EventWrittenEventArgs .

Propriedade ActivityId

Ao usar System.Activities.Activity e suas classes derivadas, os threads podem ser marcados como tendo uma atividade associada a elas. A ActivityId propriedade retorna a ID da atividade do thread que registrou o evento. Observe que os threads não precisam ter uma atividade; nesse caso, essa propriedade retorna Guid.Empty.

Propriedades OSThreadId e carimbo de data

A partir do .NET Core 2.2, objetos EventListener podem assinar eventos nativos de tempo de execução (como eventos de GC, JIT e pool de threads), além de eventos emitidos por objetos EventSource. Nas versões anteriores do .NET Core e em todas as versões do .NET Framework, a ID do thread e o carimbo de data/hora podem ser coletados do ambiente, pois são expedidos de forma síncrona no mesmo thread que os emitia. No entanto, nem todos os eventos de runtime nativos podem ser expedidos de forma síncrona. Alguns eventos, como eventos de GC, são emitidos quando a execução do thread gerenciado é suspensa. Esses eventos são armazenados em buffer no código nativo e são enviados por um thread do dispatcher depois que o código gerenciado pode ser executado novamente. Como esses eventos são armazenados em buffer, o ambiente não pode ser usado para recuperar de forma confiável a ID do thread e o carimbo de data/hora. Por isso, a partir do .NET Core 2.2, as informações de ID do thread e carimbo de data/hora estão disponíveis como membros da classe EventWrittenEventArgs.

Propriedade RelatedActivityId

Uma atividade relacionada é uma atividade fortemente relacionada à atual. Normalmente, é a atividade que causou a atividade atual (eventos com o Start opcode normalmente fazem isso) ou uma atividade que foi criada pela atual (eventos com o Send opcode normalmente fazem isso). Quando ele é usado, o RelatedActivityID é passado explicitamente pelo método fazendo o registro em log. Muitos eventos não passam um RelatedActivityId, caso em que essa propriedade retornará Guid.Empty.