Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método TraceSource.TraceEvent (TraceEventType, Int32, String, Object[])

 

Publicado: octubre de 2016

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.

Espacio de nombres:   System.Diagnostics
Ensamblado:  System (en System.dll)

[ConditionalAttribute("TRACE")]
public void TraceEvent(
	TraceEventType eventType,
	int id,
	string format,
	params object[] args
)

Parámetros

eventType
Type: System.Diagnostics.TraceEventType

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

id
Type: System.Int32

Identificador numérico para el evento.

format
Type: System.String

Cadena de formato compuesto (vea la sección Comentarios) que contiene texto combinado con cero o más elementos de formato, que corresponden a objetos de la matriz args.

args
Type: System.Object[]

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

Exception Condition
ArgumentNullException

El valor de format es null.

FormatException

format no es válido.

O bien

El número que indica el argumento de formato es menor que cero, o mayor o igual que el número de especificado para dar formato a los objetos.

ObjectDisposedException

Se intentó realizar un seguimiento de un evento durante la finalización.

Para obtener más información acerca del parámetro format, vea Formatos compuestos.

El TraceEvent método está pensado para eventos de seguimiento que se pueden procesar automáticamente mediante herramientas. 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.

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

El contenido de seguimiento es específico del agente de escucha. 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 el String.Format(IFormatProvider, String, Object[]) método, pasando el format cadena y args matriz y utilizar el CultureInfo.InvariantCulture propiedad para dar formato a la cadena como la salida del mensaje.

System_CAPS_noteNota

La EventLogTraceListener objeto está limitado a un máximo id valor de 65.535. Si el id valor especificado es mayor que 65.535, la EventLogTraceListener de objeto usa 65.535.

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. Este ejemplo de código forma parte de un ejemplo mayor proporcionado para el TraceSource clase.

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

.NET Framework
Disponible desde 2.0
Volver al principio
Mostrar: