EventLogTraceListener.TraceData Método

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.EventLog.dll

Paquete:

System.Diagnostics.EventLog v8.0.0

Escribe la información de seguimiento en el registro de eventos.

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.
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.

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

Source:

EventLogTraceListener.cs

Escribe la información de seguimiento, un objeto de datos y la información de evento en el registro de eventos.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::Object ^ data);

[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceData (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, object data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity 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.

source

String

Nombre usado para identificar el resultado; normalmente es el nombre de la aplicación que generó el evento de seguimiento.

severity

TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento que ha causado el seguimiento.

id

Int32

Identificador numérico para el evento. La combinación de source e id identifica de manera única un evento.

data

Object

Objeto de datos que se va a escribir en el archivo de salida o el flujo de salida.

Atributos

ComVisibleAttribute

Excepciones

ArgumentException

source no se especifica.

o bien

La cadena de entrada de registro supera 32.766 caracteres.

Comentarios

Importante

El TraceData código de aplicación no está diseñado para llamar a los métodos. Se llaman mediante métodos de las Debugclases , Tracey TraceSource para generar datos de seguimiento.

El TraceData método, como el TraceEvent método, está diseñado para herramientas automatizadas, pero también permite la asociación de objetos adicionales, por ejemplo, una instancia de excepción, al seguimiento.

Los eventCache parámetros y source se usan para determinar si se debe realizar un seguimiento del evento. id se usa para crear un EventInstance objeto y TraceEventType se equivale a un EventLogEntryType para la EntryType propiedad . EventInstance se escribe en el registro de eventos con el data objeto , con formato de cadena, mediante el WriteEvent método .

Nota

El valor máximo del id parámetro es 65 535. Si el id valor especificado es mayor que 65 535, se usa el valor máximo.

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

Source:

EventLogTraceListener.cs

Escribe la información de seguimiento, una matriz de objetos de datos y la información de evento en el registro de eventos.

public:
 override void TraceData(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, 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 severity, int id, params object[] data);

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceData : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * obj[] -> unit

Public Overrides Sub TraceData (eventCache As TraceEventCache, source As String, severity 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.

source

String

Nombre usado para identificar el resultado; normalmente es el nombre de la aplicación que generó el evento de seguimiento.

severity

TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento que ha causado el seguimiento.

id

Int32

Identificador numérico para el evento. La combinación de source e id identifica de manera única un evento.

data

Object[]

Matriz de objetos de datos.

Atributos

ComVisibleAttribute

Excepciones

ArgumentException

source no se especifica.

o bien

La cadena de entrada de registro supera 32.766 caracteres.

Comentarios

Importante

El TraceData código de aplicación no está diseñado para llamar a los métodos. Se llaman mediante métodos de las Debugclases , Tracey TraceSource para generar datos de seguimiento.

El TraceData método, como el TraceEvent método, está diseñado para herramientas automatizadas, pero también permite la asociación de objetos adicionales, por ejemplo, una instancia de excepción, al seguimiento.

Los severity datos de parámetro y id se usan para crear un EventInstance objeto, que se escribe en el registro de eventos con los datos de la matriz de objetos de datos.

Los eventCache parámetros y source se usan para determinar si se debe realizar un seguimiento del evento. id se usa para crear un EventInstance objeto y TraceEventType se equivale a un EventLogEntryType para la EntryType propiedad . EventInstance se escribe en el registro de eventos con la data matriz de objetos, con formato de matriz de cadenas, mediante el WriteEvent método .

Nota

El valor máximo del id parámetro es 65 535. Si el id valor especificado es mayor que 65 535, se usa el valor máximo.