EventLogTraceListener.TraceEvent Método

Definición

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

Sobrecargas

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

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

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

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

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

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

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ message);
[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string message);
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, message As String)

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.

message
String

Mensaje de seguimiento.

Atributos

Excepciones

source no se especifica.

o bien

La cadena de entrada de registro supera 32.766 caracteres.

Comentarios

Importante

El código de aplicación no está diseñado para llamar a los TraceEvent métodos. Los métodos de las Debugclases , Tracey TraceSource llaman a estos métodos para escribir datos de seguimiento.

El TraceEvent método está pensado para realizar un seguimiento de eventos que las herramientas pueden procesar automáticamente. Por ejemplo, una herramienta de supervisión puede notificar a un administrador si un origen específico realiza un seguimiento de un evento específico.

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 los message datos 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.

Se aplica a

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

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

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType severity, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
[System.Runtime.InteropServices.ComVisible(false)]
public override void TraceEvent (System.Diagnostics.TraceEventCache eventCache, string source, System.Diagnostics.TraceEventType severity, int id, string format, params object[] args);
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, severity As TraceEventType, id As Integer, format As String, ParamArray args 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.

format
String

Cadena de formato que contiene cero o más elementos de formato que corresponden a los objetos de la matriz args.

args
Object[]

Matriz de object que contiene cero o más objetos a los que se va a aplicar formato.

Atributos

Excepciones

source no se especifica.

o bien

La cadena de entrada de registro supera 32.766 caracteres.

Comentarios

Importante

El código de aplicación no está diseñado para llamar a los TraceEvent métodos. Los métodos de las Debugclases , Tracey TraceSource llaman a estos métodos para escribir datos de seguimiento.

El TraceEvent método está pensado para realizar un seguimiento de eventos que las herramientas pueden procesar automáticamente. Por ejemplo, una herramienta de supervisión puede notificar a un administrador si un origen específico realiza un seguimiento de un evento específico.

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, mediante el WriteEvent método , con el mensaje obtenido de los format parámetros y args . La args matriz de objetos se convierte en una cadena mediante el Format método , pasando la format cadena y args la matriz para dar formato a la cadena como mensaje para el registro de eventos.

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.

Se aplica a