Comparteix a través de


FileLogTraceListener.TraceEvent Método

Definición

Escribe información de eventos y de seguimiento en el archivo de salida o el flujo de salida.

Sobrecargas

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

Escribe la información de seguimiento, un mensaje y la información de evento en el archivo de salida o el flujo de salida.

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 archivo de salida o el flujo de salida.

Comentarios

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

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

Escribe la información de seguimiento, un mensaje y la información de evento en el archivo de salida o el flujo de salida.

public:
 override void TraceEvent(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
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 TraceEventCache que contiene el identificador de proceso actual, el identificador de subproceso e información sobre el seguimiento de la pila.

source
String

Nombre del origen de seguimiento que invocó este método.

eventType
TraceEventType

Uno de los valores de enumeración de TraceEventType.

id
Int32

Identificador numérico para el evento.

message
String

Mensaje que se va a escribir.

Comentarios

Este método:

  1. Da formato a los datos y la información de contexto para la salida.

  2. Crea un nuevo archivo de registro, si es necesario.

  3. Escribe la información en el archivo de registro.

Para obtener más información sobre cómo crear nuevos archivos de registro, vea FullLogFileName.

En esta tabla se enumeran los campos de salida en el orden en que aparecen. Los campos están delimitados por la cadena que especifica la Delimiter propiedad y van seguidos de un terminador de línea.

Campo Condición de salida Descripción
source Siempre. El valor de name.
severity Siempre. Nombre de valor de enumeración de eventType.
id Siempre. Representación de cadena de id.
message Siempre. El valor de message.
callStack Cuando la Callstack marca se establece en la TraceOutputOptions propiedad . Propiedad Callstack de eventCache.
CorrelationID Cuando la LogicalOperationStack marca se establece en la TraceOutputOptions propiedad . Propiedad ThreadId de eventCache.
DateTime Cuando la DateTime marca se establece en la TraceOutputOptions propiedad . Representación de cadena de la DateTime propiedad de eventCache. La referencia cultural invariable se usa para la conversión de cadena.
ProcessID Cuando la ProcessId marca se establece en la TraceOutputOptions propiedad . Representación de cadena de la ProcessId propiedad de eventCache. La referencia cultural invariable se usa para la conversión de cadena.
ThreadID Cuando la ThreadId marca se establece en la TraceOutputOptions propiedad . Propiedad ThreadId de eventCache.
Timestamp Cuando la Timestamp marca se establece en la TraceOutputOptions propiedad . Representación de cadena de la Timestamp propiedad de eventCache. La referencia cultural invariable se usa para la conversión de cadena.
HostName Cuando la IncludeHostName propiedad es True. El nombre del equipo.

Consulte también

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 archivo de salida o el flujo de salida.

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);
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 TraceEventCache que contiene el identificador de proceso actual, el identificador de subproceso e información sobre el seguimiento de la pila.

source
String

Nombre del origen de seguimiento que invocó este método.

eventType
TraceEventType

Uno de los valores de enumeración de TraceEventType.

id
Int32

Identificador numérico para el evento.

format
String

Cadena de formato que contiene cero o más elementos de formato, que corresponden a 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.

Comentarios

Este método:

  1. Da formato a los datos y la información de contexto para la salida.

  2. Crea un nuevo archivo de registro, si es necesario.

  3. Escribe la información en el archivo de registro.

Para obtener más información sobre cómo crear un nuevo archivo de registro, vea FullLogFileName.

En esta tabla se enumeran los campos de salida en el orden en que aparecen. Los campos están delimitados por la cadena que especifica la Delimiter propiedad y seguidos de un terminador de línea.

Campo Condición de salida Descripción
source Siempre El valor de name.
severity Siempre Nombre de valor de enumeración de eventType.
id Siempre Representación de cadena de id.
message Siempre Los datos con args formato con la format cadena y usan la referencia cultural invariable para las conversiones de cadenas.
callStack Cuando la Callstack marca se establece en la TraceOutputOptions propiedad . Propiedad Callstack de eventCache.
CorrelationID Cuando la LogicalOperationStack marca se establece en la TraceOutputOptions propiedad . Propiedad ThreadId de eventCache.
DateTime Cuando la DateTime marca se establece en la TraceOutputOptions propiedad . Representación de cadena de la DateTime propiedad de eventCache. La referencia cultural invariable se usa para la conversión de cadena.
ProcessID Cuando la ProcessId marca se establece en la TraceOutputOptions propiedad . Representación de cadena de la ProcessId propiedad de eventCache. La referencia cultural invariable se usa para la conversión de cadena.
ThreadID Cuando la ThreadId marca se establece en la TraceOutputOptions propiedad . Propiedad ThreadId de eventCache.
Timestamp Cuando la Timestamp marca se establece en la TraceOutputOptions propiedad . Representación de cadena de la Timestamp propiedad de eventCache. La referencia cultural invariable se usa para la conversión de cadena.
HostName Cuando la IncludeHostName propiedad es True. El nombre del equipo.

Consulte también

Se aplica a