TraceSource.TraceEvent Método

Definición

Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners.

Sobrecargas

TraceEvent(TraceEventType, Int32)

Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento y el identificador de evento especificados.

TraceEvent(TraceEventType, Int32, String)

Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el mensaje especificados.

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

Escribe un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el formato y la matriz de argumentos especificados.

TraceEvent(TraceEventType, Int32)

Source:
TraceSource.cs
Source:
TraceSource.cs
Source:
TraceSource.cs

Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento y el identificador de evento especificados.

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);

Parámetros

eventType
TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.

id
Int32

Identificador numérico para el evento.

Atributos

Excepciones

Se ha intentado realizar la traza de un evento durante la finalización.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del TraceEvent(TraceEventType, Int32) método para pasar un evento de seguimiento a los agentes de escucha. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase TraceSource.

ts.TraceEvent(TraceEventType.Warning, 1);

Comentarios

El TraceEvent método está diseñado 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.

El TraceEvent método llama al ShouldTrace método del SourceSwitch objeto devuelto por la Switch propiedad . Si ShouldTrace devuelve true, TraceEvent llama al método correspondiente TraceEvent de cada agente de escucha. De lo contrario, TraceEvent devuelve sin llamar a los métodos de los agentes de escucha.

El contenido de seguimiento es específico del agente de escucha. Si la implementación del agente de escucha no invalida el método, la salida predeterminada es el nombre del origen de seguimiento, su identidad numérica y el tipo de evento. El contenido de seguimiento adicional depende del valor de propiedad del agente de TraceOutputOptions escucha.

Nota

El EventLogTraceListener objeto está limitado a un valor máximo id de 65 535. Si el id valor especificado es mayor que 65 535, usa EventLogTraceListener 65 535.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

TraceEvent(TraceEventType, Int32, String)

Source:
TraceSource.cs
Source:
TraceSource.cs
Source:
TraceSource.cs

Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el mensaje especificados.

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);

Parámetros

eventType
TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.

id
Int32

Identificador numérico para el evento.

message
String

Mensaje de seguimiento que se va a escribir.

Atributos

Excepciones

Se ha intentado realizar la traza de un evento durante la finalización.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del TraceEvent(TraceEventType, Int32) método para pasar un evento de seguimiento a los agentes de escucha. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase TraceSource.

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

Comentarios

El TraceEvent método está diseñado 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.

El TraceEvent método llama al ShouldTrace método del SourceSwitch objeto devuelto por la Switch propiedad . Si ShouldTrace devuelve true, TraceEvent llama al método correspondiente TraceEvent de cada agente de escucha. De lo contrario, TraceEvent devuelve sin llamar a los métodos de los agentes de escucha.

El contenido de seguimiento es específico del agente de escucha. Si la implementación del agente de escucha no invalida el método, la salida predeterminada es el nombre del origen de seguimiento, su identidad numérica, el tipo de evento y el mensaje. El contenido de seguimiento adicional depende del valor de propiedad del agente de TraceOutputOptions escucha.

Nota

El EventLogTraceListener objeto está limitado a un valor máximo id de 65 535. Si el id valor especificado es mayor que 65 535, el EventLogTraceListener objeto usa 65 535.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

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

Source:
TraceSource.cs
Source:
TraceSource.cs
Source:
TraceSource.cs

Escribe un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el formato y la matriz de argumentos especificados.

[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object?[]? args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);

Parámetros

eventType
TraceEventType

Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.

id
Int32

Identificador numérico para el evento.

format
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.

args
Object[]

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

Atributos

Excepciones

format es null.

format no es válido.

o bien

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.

Se ha intentado realizar la traza de un evento durante la finalización.

Ejemplos

En el ejemplo de código siguiente se muestra el uso del TraceEvent(TraceEventType, Int32) método para pasar un evento de seguimiento a los agentes de escucha. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase TraceSource.

// 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 el format parámetro , vea Formato compuesto.

El TraceEvent método está diseñado 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.

El TraceEvent método llama al ShouldTrace método del SourceSwitch objeto devuelto por la Switch propiedad . Si ShouldTrace devuelve true, TraceEvent llama al método correspondiente TraceEvent de cada agente de escucha. De lo contrario, TraceEvent devuelve sin llamar a los métodos de los agentes de escucha.

El contenido de seguimiento es específico del agente de escucha. El método predeterminado TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) escribe el nombre de origen, el tipo de evento y la identidad numérica en el encabezado de seguimiento y, a continuación, llama al String.Format(IFormatProvider, String, Object[]) método , pasando la format cadena y args la matriz y usando la CultureInfo.InvariantCulture propiedad para dar formato a la cadena como salida del mensaje.

Nota

El EventLogTraceListener objeto está limitado a un valor máximo id de 65 535. Si el id valor especificado es mayor que 65 535, el EventLogTraceListener objeto usa 65 535.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1