EventWrittenEventArgs Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona datos para la devolución de OnEventWritten(EventWrittenEventArgs) llamada.
public ref class EventWrittenEventArgs : EventArgs
public class EventWrittenEventArgs : EventArgs
type EventWrittenEventArgs = class
inherit EventArgs
Public Class EventWrittenEventArgs
Inherits EventArgs
- Herencia
Comentarios
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.
Propiedades
| Nombre | Description |
|---|---|
| ActivityId |
Obtiene el identificador de actividad del subproceso en el que se escribió el evento. |
| Channel |
Obtiene el canal del evento. |
| EventId |
Obtiene el identificador de evento. |
| EventName |
Obtiene el nombre del evento. |
| EventSource |
Obtiene el objeto de origen del evento. |
| Keywords |
Obtiene las palabras clave del evento. |
| Level |
Obtiene el nivel del evento. |
| Message |
Obtiene el mensaje del evento. |
| Opcode |
Obtiene el código de operación para el evento. |
| OSThreadId |
Obtiene el identificador de subproceso del subproceso del sistema operativo que escribió el evento. (solo .NET Core 2.2 y versiones posteriores). |
| Payload |
Obtiene la carga del evento. |
| PayloadNames |
Devuelve una lista de cadenas que representan los nombres de propiedad del evento. |
| RelatedActivityId |
Obtiene el identificador de una actividad relacionada con la actividad representada por la instancia actual. |
| Tags |
Devuelve las etiquetas especificadas en la llamada al Write(String, EventSourceOptions) método . |
| Task |
Obtiene la tarea del evento. |
| TimeStamp |
Obtiene la hora en que el evento se generó originalmente como marca DateTime de tiempo. (solo .NET Core 2.2 y versiones posteriores). |
| Version |
Obtiene la versión del evento. |
Métodos
| Nombre | Description |
|---|---|
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |