EventWrittenEventArgs Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece dados para o OnEventWritten(EventWrittenEventArgs) callback.
public ref class EventWrittenEventArgs : EventArgspublic class EventWrittenEventArgs : EventArgstype EventWrittenEventArgs = class
inherit EventArgsPublic Class EventWrittenEventArgs
Inherits EventArgs- Herança
Observações
A EventWrittenEventArgs classe fornece dados para a chamada de retorno OnEventWritten.
Sempre que um evento é enviado para um EventListener, o método de callback EventListener.OnEventWritten é invocado. É passada para uma EventWrittenEventArgs instância que contém informações associadas ao evento. Todos os valores de propriedade da classe EventWrittenEventArgs são válidos somente durante o callback.
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 eles. A ActivityId propriedade retorna a ID de atividade do thread que registrou o evento. Observe que os threads não precisam ter uma atividade, caso em que essa propriedade retorna Guid.Empty.
Propriedades OSThreadId e TimeStamp
A partir do .NET Core 2.2, EventListener os objetos podem inscrever-se em eventos nativos de runtime (como GC, JIT e eventos de threadpool), além de eventos que objetos EventSource emitem. Em 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, porque eles são despachados de forma síncrona no mesmo thread que os emitiu. No entanto, nem todos os eventos de tempo de execução nativos podem ser despachados de forma síncrona. Alguns eventos, como eventos 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 despachados por um thread do dispatcher assim 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 de thread e carimbo de data/hora estão disponíveis como membros da classe EventWrittenEventArgs.
Propriedade RelatedActivityId
Uma atividade relacionada é uma atividade que está fortemente relacionada com a atual. Normalmente, é a atividade que causou a atividade atual (eventos com o Start opcode normalmente fazem isso) ou uma atividade que foi criada pelo atual (eventos com o Send opcode normalmente fazem isso). Quando é usado, o RelatedActivityID é explicitamente passado pelo método que faz o registro. Muitos eventos não passam um RelatedActivityId, caso em que esta propriedade retorna Guid.Empty.
Propriedades
| Name | Descrição |
|---|---|
| ActivityId |
Obtém o ID de atividade no thread onde o evento foi escrito. |
| Channel |
Recebe o canal do evento. |
| EventId |
Obtém o identificador do evento. |
| EventName |
Fica com o nome do evento. |
| EventSource |
Obtém o objeto de origem do evento. |
| Keywords |
Obtém as palavras-chave do evento. |
| Level |
Percebe o nível do evento. |
| Message |
Percebe a mensagem do evento. |
| Opcode |
Obtém o código de operação do evento. |
| OSThreadId |
Obtém o identificador de thread do thread do sistema operativo que escreveu o evento. (.NET Core 2.2 e posteriores apenas.) |
| Payload |
Recebe a carga útil para o evento. |
| PayloadNames |
Devolve uma lista de cadeias que representam os nomes das propriedades do evento. |
| RelatedActivityId |
Obtém o identificador de uma atividade relacionada com a atividade representada pela instância atual. |
| Tags |
Devolve as etiquetas especificadas na chamada ao Write(String, EventSourceOptions) método. |
| Task |
Recebe a tarefa do evento. |
| TimeStamp |
Recebe a hora em que o evento foi originalmente gerado como carimbo DateTime temporal. (.NET Core 2.2 e posteriores apenas.) |
| Version |
Recebe a versão do acontecimento. |
Métodos
| Name | Descrição |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
