TraceSource.TraceEvent TraceSource.TraceEvent TraceSource.TraceEvent TraceSource.TraceEvent Method

Definición

Escribe un mensaje de un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners.Writes a trace event message to the trace listeners in the Listeners collection.

Sobrecargas

TraceEvent(TraceEventType, Int32) TraceEvent(TraceEventType, Int32) TraceEvent(TraceEventType, Int32) TraceEvent(TraceEventType, Int32)

Escribe un mensaje de un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento y el identificador de evento especificados.Writes a trace event message to the trace listeners in the Listeners collection using the specified event type and event identifier.

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

Escribe un mensaje de un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento, el identificador de evento y el mensaje especificados.Writes a trace event message to the trace listeners in the Listeners collection using the specified event type, event identifier, and message.

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

Escribe un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento, el identificador de evento, la matriz de argumentos y el formato especificados.Writes a trace event to the trace listeners in the Listeners collection using the specified event type, event identifier, and argument array and format.

TraceEvent(TraceEventType, Int32) TraceEvent(TraceEventType, Int32) TraceEvent(TraceEventType, Int32) TraceEvent(TraceEventType, Int32)

Escribe un mensaje de un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento y el identificador de evento especificados.Writes a trace event message to the trace listeners in the Listeners collection using the specified event type and event identifier.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer)

Parámetros

eventType
TraceEventType TraceEventType TraceEventType TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.One of the enumeration values that specifies the event type of the trace data.

id
Int32 Int32 Int32 Int32

Identificador numérico para el evento.A numeric identifier for the event.

Excepciones

Se ha intentado realizar la traza de un evento durante la finalización.An attempt was made to trace an event during finalization.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de la TraceEvent(TraceEventType, Int32) método para pasar un evento de seguimiento a los agentes de escucha.The following code example shows the use of the TraceEvent(TraceEventType, Int32) method to pass a trace event to the listeners. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para el TraceSource clase.This code example is part of a larger example provided for the TraceSource class.

ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)

Comentarios

El TraceEvent método está pensado para eventos de seguimiento que se pueden procesar automáticamente por herramientas.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 se realiza un seguimiento de un evento específico por un origen específico.For example, a monitoring tool can notify an administrator if a specific event is traced by a specific source.

El TraceEvent llamadas al método el ShouldTrace método de la SourceSwitch objeto devuelto por la Switch propiedad.The TraceEvent method calls the ShouldTrace method of the SourceSwitch object returned by the Switch property. Si ShouldTrace devuelve true, TraceEvent llama a la correspondiente TraceEvent método de cada agente de escucha.If ShouldTrace returns true, TraceEvent calls the corresponding TraceEvent method of each listener. En caso contrario, TraceEvent devuelve sin llamar a métodos de los agentes de escucha.Otherwise, TraceEvent returns without calling the listeners' methods.

El contenido de seguimiento es específico del agente de escucha.The trace content is listener specific. Si el método no se reemplaza por la implementación de agente de escucha, la salida predeterminada es el nombre del origen de seguimiento, su identidad numérica y el tipo de evento.If the method is not overridden by the listener implementation, the default output is the name of the trace source, its numeric identity, and the event type. Contenido de seguimiento adicional depende de si el agente de escucha TraceOutputOptions valor de propiedad.Additional trace content is dependent upon the listener's TraceOutputOptions property value.

Nota

El EventLogTraceListener objeto está limitado a un máximo id valor de 65.535.The EventLogTraceListener object is limited to a maximum id value of 65,535. Si el id valor especificado es mayor que 65.535, la EventLogTraceListener usa 65.535.If the id value specified is greater than 65,535, the EventLogTraceListener uses 65,535.

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

Escribe un mensaje de un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento, el identificador de evento y el mensaje especificados.Writes a trace event message to the trace listeners in the Listeners collection using the specified event type, event identifier, and message.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)

Parámetros

eventType
TraceEventType TraceEventType TraceEventType TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.One of the enumeration values that specifies the event type of the trace data.

id
Int32 Int32 Int32 Int32

Identificador numérico para el evento.A numeric identifier for the event.

message
String String String String

Mensaje de seguimiento que se va a escribir.The trace message to write.

Excepciones

Se ha intentado realizar la traza de un evento durante la finalización.An attempt was made to trace an event during finalization.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de la TraceEvent(TraceEventType, Int32) método para pasar un evento de seguimiento a los agentes de escucha.The following code example shows the use of the TraceEvent(TraceEventType, Int32) method to pass a trace event to the listeners. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para el TraceSource clase.This code example is part of a larger example provided for the TraceSource class.

// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");
' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")

Comentarios

El TraceEvent método está pensado para eventos de seguimiento que se pueden procesar automáticamente por herramientas.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 se realiza un seguimiento de un evento específico por un origen específico.For example, a monitoring tool can notify an administrator if a specific event is traced by a specific source.

El TraceEvent llamadas al método el ShouldTrace método de la SourceSwitch objeto devuelto por la Switch propiedad.The TraceEvent method calls the ShouldTrace method of the SourceSwitch object returned by the Switch property. Si ShouldTrace devuelve true, TraceEvent llama a la correspondiente TraceEvent método de cada agente de escucha.If ShouldTrace returns true, TraceEvent calls the corresponding TraceEvent method of each listener. En caso contrario, TraceEvent devuelve sin llamar a métodos de los agentes de escucha.Otherwise, TraceEvent returns without calling the listeners' methods.

El contenido de seguimiento es específico del agente de escucha.The trace content is listener specific. Si el método no se reemplaza por la implementación de agente de escucha, la salida predeterminada es el nombre del origen de seguimiento, su identidad numérica, el tipo de evento y el mensaje.If the method is not overridden by the listener implementation, the default output is the name of the trace source, its numeric identity, the event type, and the message. Contenido de seguimiento adicional depende de si el agente de escucha TraceOutputOptions valor de propiedad.Additional trace content is dependent upon the listener's TraceOutputOptions property value.

Nota

El EventLogTraceListener objeto está limitado a un máximo id valor de 65.535.The EventLogTraceListener object is limited to a maximum id value of 65,535. Si el id valor especificado es mayor que 65.535, la EventLogTraceListener de objeto usa 65.535.If the id value specified is greater than 65,535, the EventLogTraceListener object uses 65,535.

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

Escribe un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners utilizando el tipo de evento, el identificador de evento, la matriz de argumentos y el formato especificados.Writes a trace event to the trace listeners in the Listeners collection using the specified event type, event identifier, and argument array and format.

public:
 void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())

Parámetros

eventType
TraceEventType TraceEventType TraceEventType TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.One of the enumeration values that specifies the event type of the trace data.

id
Int32 Int32 Int32 Int32

Identificador numérico para el evento.A numeric identifier for the event.

format
String String String String

Cadena con formato compuesto que contiene texto mezclado con cero o más elementos de formato que corresponden a objetos de la matriz args.A composite format string that contains text intermixed with zero or more format items, which 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.

Excepciones

format no es válido.format is invalid.

O bien-or- El número que indica que un argumento al que se va a dar formato es menor que cero, o mayor o igual que el número de objetos proporcionados a los que se va a dar formato.The number that indicates an argument to format is less than zero, or greater than or equal to the number of specified objects to format.

Se ha intentado realizar la traza de un evento durante la finalización.An attempt was made to trace an event during finalization.

Ejemplos

En el ejemplo de código siguiente se muestra el uso de la TraceEvent(TraceEventType, Int32) método para pasar un evento de seguimiento a los agentes de escucha.The following code example shows the use of the TraceEvent(TraceEventType, Int32) method to pass a trace event to the listeners. Este ejemplo de código forma parte de un ejemplo más extenso proporcionado para el TraceSource clase.This code example is part of a larger example provided for the TraceSource class.

// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");
' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")

Comentarios

Para obtener más información sobre la format parámetro, vea formatos compuestos.For more information about the format parameter, see Composite Formatting.

El TraceEvent método está pensado para eventos de seguimiento que se pueden procesar automáticamente por herramientas.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 se realiza un seguimiento de un evento específico por un origen específico.For example, a monitoring tool can notify an administrator if a specific event is traced by a specific source.

El TraceEvent llamadas al método el ShouldTrace método de la SourceSwitch objeto devuelto por la Switch propiedad.The TraceEvent method calls the ShouldTrace method of the SourceSwitch object returned by the Switch property. Si ShouldTrace devuelve true, TraceEvent llama a la correspondiente TraceEvent método de cada agente de escucha.If ShouldTrace returns true, TraceEvent calls the corresponding TraceEvent method of each listener. En caso contrario, TraceEvent devuelve sin llamar a métodos de los agentes de escucha.Otherwise, TraceEvent returns without calling the listeners' methods.

El contenido de seguimiento es específico del agente de escucha.The trace content is listener specific. El valor predeterminado TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) método escribe el nombre de origen, el tipo de evento y la identidad numérica en el encabezado de seguimiento, a continuación, llama a la String.Format(IFormatProvider, String, Object[]) método, pasando el format cadena y args matriz y el uso de la CultureInfo.InvariantCulture propiedad para dar formato a la cadena como la salida del mensaje.The default TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) method writes the source name, event type, and numeric identity in the trace header, then calls the String.Format(IFormatProvider, String, Object[]) method, passing the format string and args array and using the CultureInfo.InvariantCulture property to format the string as the message output.

Nota

El EventLogTraceListener objeto está limitado a un máximo id valor de 65.535.The EventLogTraceListener object is limited to a maximum id value of 65,535. Si el id valor especificado es mayor que 65.535, la EventLogTraceListener de objeto usa 65.535.If the id value specified is greater than 65,535, the EventLogTraceListener object uses 65,535.

Consulte también:

Se aplica a