EventLogTraceListener.TraceEvent Método

Definición

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

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.Writes trace information, a message, and event information to the event log.

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.Writes trace information, a formatted array of objects, and event information to the event log.

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.Writes trace information, a message, and event information to the event log.

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

message
String

Mensaje de seguimiento.The trace message.

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 TraceEvent no están diseñados para ser llamados por el código de la aplicación.The TraceEvent methods are not intended to be called by application code. Los métodos de las clases Debug, Tracey TraceSource llaman a estos métodos para escribir datos de seguimiento.These methods are called by methods of the Debug, Trace, and TraceSource classes to write trace data.

El método TraceEvent está diseñado para realizar un seguimiento de los eventos que las herramientas de pueden procesar automáticamente.The TraceEvent method is intended to trace events that can be processed automatically by tools. 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.For example a monitoring tool can notify an administrator if a specific event is traced by a specific source.

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 los datos de message mediante el método WriteEvent.The EventInstance is written to the event log with the message data 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.

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.Writes trace information, a formatted array of objects, and event information to the event log.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, 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 eventType, int id, string format, params object[] args);
override this.TraceEvent : System.Diagnostics.TraceEventCache * string * System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Overrides Sub TraceEvent (eventCache As TraceEventCache, source As String, eventType 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.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.

format
String

Cadena de formato que contiene cero o más elementos de formato que corresponden a los objetos de la matriz args.A format string that contains zero or more format items that correspond to objects in the args array.

args
Object[]

Matriz de object que contiene cero o más objetos a los que se va a dar formato.An object array containing zero or more objects to format.

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 TraceEvent no están diseñados para ser llamados por el código de la aplicación.The TraceEvent methods are not intended to be called by application code. Los métodos de las clases Debug, Tracey TraceSource llaman a estos métodos para escribir datos de seguimiento.These methods are called by methods of the Debug, Trace, and TraceSource classes to write trace data.

El método TraceEvent está diseñado para realizar un seguimiento de los eventos que las herramientas de pueden procesar automáticamente.The TraceEvent method is intended to trace events that can be processed automatically by tools. 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.For example a monitoring tool can notify an administrator if a specific event is traced by a specific source.

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, mediante el método WriteEvent, con el mensaje Obtenido de los parámetros format y args.The EventInstance is written to the event log, using the WriteEvent method, with the message obtained from the format and args parameters. La matriz de objetos de args se convierte en una cadena mediante el método Format, pasando la cadena format y args matriz para dar formato a la cadena como el mensaje del registro de eventos.The args object array is converted to a string using the Format method, passing the format string and args array to format the string as the message for the event log.

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