FileLogTraceListener.TraceEvent Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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:
Da formato a los datos y la información de contexto para la salida.
Crea un nuevo archivo de registro, si es necesario.
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:
Da formato a los datos y la información de contexto para la salida.
Crea un nuevo archivo de registro, si es necesario.
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. |