EventLogTraceListener.TraceData Método

Definición

Escribe la información de seguimiento en el registro de eventos.Writes trace data to the event log.

Sobrecargas

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Escribe la información de seguimiento, un objeto de datos y la información de evento en el registro de eventos.Writes trace information, a data object, and event information to the event log.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en el registro de eventos.Writes trace information, an array of data objects, and event information to the event log.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Escribe la información de seguimiento, un objeto de datos y la información de evento en el registro de eventos.Writes trace information, a data object, and event information to the event log.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::Object ^ data);
[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, object data);
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit
Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, data As Object)

Parámetros

eventCache
TraceEventCache

Objeto que contiene el identificador de proceso actual, el identificador de subproceso e información sobre el seguimiento de la pila.An object that contains the current process ID, thread ID, and stack trace information.

source
String

Nombre usado para identificar el resultado; normalmente es el nombre de la aplicación que generó el evento de seguimiento.A name used to identify the output; typically the name of the application that generated the trace event.

severity
TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento que ha causado el seguimiento.One of the enumeration values that specifies the type of event that has caused the trace.

id
Int32

Identificador numérico para el evento.A numeric identifier for the event. La combinación de source e id identifica de manera única un evento.The combination of source and id uniquely identifies an event.

data
Object

Objeto de datos que se va a escribir en el archivo de salida o el flujo de salida.A data object to write to the output file or stream.

Atributos

Excepciones

No se especificó source.source is not specified.

O bien,-or- La cadena de entrada de registro supera 32.766 caracteres.The log entry string exceeds 32,766 characters.

Comentarios

Importante

Los métodos TraceData no están diseñados para ser llamados por el código de la aplicación.The TraceData methods are not intended to be called by application code. Los métodos de las clases Debug, Tracey TraceSource llaman a ellos para generar los datos de seguimiento.They are called by methods of the Debug, Trace, and TraceSource classes to output trace data.

El método TraceData, al igual que el método TraceEvent está pensado para herramientas automatizadas, pero también permite adjuntar objetos adicionales, por ejemplo, una instancia de excepción, al seguimiento.The TraceData method, like the TraceEvent method is intended for automated tools but also allows the attaching of additional objects, for example an exception instance, to the trace.

Los parámetros eventCache y source se usan para determinar si se debe realizar un seguimiento del evento.The eventCache and source parameters are used to determine if the event should be traced. id se usa para crear un objeto EventInstance y el TraceEventType se equipara a un EventLogEntryType para la propiedad EntryType.id is used to create an EventInstance object and the TraceEventType is equated to an EventLogEntryType for the EntryType property. El EventInstance se escribe en el registro de eventos con el data objeto, con el formato de cadena, mediante el método WriteEvent.The EventInstance is written to the event log with the data object, formatted as a string, using the WriteEvent method.

Nota

El valor máximo del parámetro id es 65.535.The maximum value of the id parameter is 65,535. Si el valor de id especificado es mayor que 65.535, se usa el valor máximo.If the id value specified is greater than 65,535, the maximum value is used.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en el registro de eventos.Writes trace information, an array of data objects, and event information to the event log.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, ... cli::array <System::Object ^> ^ data);
[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType eventType, int id, params object[] data);
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit
Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, eventType As TraceEventType, id As Integer, ParamArray data As Object())

Parámetros

eventCache
TraceEventCache

Objeto que contiene el identificador de proceso actual, el identificador de subproceso e información sobre el seguimiento de la pila.An object that contains the current process ID, thread ID, and stack trace information.

source
String

Nombre usado para identificar el resultado; normalmente es el nombre de la aplicación que generó el evento de seguimiento.A name used to identify the output; typically the name of the application that generated the trace event.

severity
TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento que ha causado el seguimiento.One of the enumeration values that specifies the type of event that has caused the trace.

id
Int32

Identificador numérico para el evento.A numeric identifier for the event. La combinación de source e id identifica de manera única un evento.The combination of source and id uniquely identifies an event.

data
Object[]

Matriz de objetos de datos.An array of data objects.

Atributos

Excepciones

No se especificó source.source is not specified.

O bien,-or- La cadena de entrada de registro supera 32.766 caracteres.The log entry string exceeds 32,766 characters.

Comentarios

Importante

Los métodos TraceData no están diseñados para ser llamados por el código de la aplicación.The TraceData methods are not intended to be called by application code. Los métodos de las clases Debug, Tracey TraceSource llaman a ellos para generar los datos de seguimiento.They are called by methods of the Debug, Trace, and TraceSource classes to output trace data.

El método TraceData, al igual que el método TraceEvent está pensado para herramientas automatizadas, pero también permite adjuntar objetos adicionales, por ejemplo, una instancia de excepción, al seguimiento.The TraceData method, like the TraceEvent method is intended for automated tools but also allows the attaching of additional objects, for example an exception instance, to the trace.

Los datos de los parámetros severity y id se utilizan para crear un objeto EventInstance, que se escribe en el registro de eventos con los datos de la matriz de objetos de datos.The severity and id parameter data is used to create an EventInstance object, which is written to the event log with the data from the array of data objects.

Los parámetros eventCache y source se usan para determinar si se debe realizar un seguimiento del evento.The eventCache and source parameters are used to determine if the event should be traced. id se usa para crear un objeto EventInstance y el TraceEventType se equipara a un EventLogEntryType para la propiedad EntryType.id is used to create an EventInstance object and the TraceEventType is equated to an EventLogEntryType for the EntryType property. El EventInstance se escribe en el registro de eventos con la data matriz de objetos, con el formato de una matriz de cadenas, utilizando el método WriteEvent.The EventInstance is written to the event log with the data object array, formatted as a string array, using the WriteEvent method.

Nota

El valor máximo del parámetro id es 65.535.The maximum value of the id parameter is 65,535. Si el valor de id especificado es mayor que 65.535, se usa el valor máximo.If the id value specified is greater than 65,535, the maximum value is used.

Se aplica a