Clase System.Diagnostics.Tracing.EventWrittenEventArgs

En este artículo se proporcionan comentarios adicionales a la documentación de referencia de esta API.

La clase EventWrittenEventArgs proporciona datos para la devolución de llamada OnEventWritten.

Cada vez que se envía un evento a un EventListener, el EventListener.OnEventWritten se invoca el método de devolución de llamada. Se pasa una instancia EventWrittenEventArgs que contiene información asociada al evento. Todos los valores de propiedad de la EventWrittenEventArgs clase son válidos solo durante la devolución de llamada.

Las secciones siguientes contienen información adicional sobre las propiedades individuales EventWrittenEventArgs .

Propiedad ActivityId

Cuando se usa System.Activities.Activity y sus clases derivadas, subprocesos pueden marcarse como si tuviera una actividad asociada con ellos. La ActivityId propiedad devuelve el identificador de actividad del subproceso que registró el evento. Observe que los subprocesos no debe tener una actividad, en cuyo caso esta propiedad devuelve Guid.Empty.

Propiedades OSThreadId y TimeStamp

A partir de .NET Core 2.2, los EventListener objetos pueden suscribirse a eventos en tiempo de ejecución nativos (como eventos GC, JIT y threadpool) además de los eventos emitidos por EventSource los objetos. En versiones anteriores de .NET Core y todas las versiones de .NET Framework, el identificador de subproceso y la marca de tiempo se pueden recopilar del entorno, ya que se envían sincrónicamente en el mismo subproceso que los emitió. Sin embargo, no todos los eventos en tiempo de ejecución nativos se pueden enviar sincrónicamente. Algunos eventos, tales como eventos de GC, se emiten cuando administrado se suspende la ejecución de subprocesos. Estos eventos se almacenan en búfer en código nativo y se envían mediante un subproceso de distribuidor una vez que el código administrado se puede ejecutar de nuevo. Dado que estos eventos se almacenan en búfer, el entorno no se puede usar para recuperar de forma confiable el identificador de subproceso y la marca de tiempo. Debido a esto, a partir de .NET Core 2.2, el identificador de subproceso y la información de marca de tiempo están disponibles como miembros de la EventWrittenEventArgs clase .

Propiedad RelatedActivityId

Una actividad relacionada es una actividad que está fuertemente relacionada con la actual. Normalmente, es la actividad que provocó la actividad actual (los eventos con el Start código de operación normalmente lo hacen) o una actividad creada por el actual (los eventos con el Send código de operación normalmente lo hacen). Cuando se utiliza, RelatedActivityID es pasado explícitamente por el método que realiza el registro. Muchos eventos no superan un RelatedActivityId, en cuyo caso esta propiedad devuelve Guid.Empty.