Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

TraceSource.TraceEvent (Método) (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.

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
Tipo: System.Diagnostics.TraceEventType
Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.
id
Tipo: System.Int32
Identificador numérico para el evento.
format
Tipo: System.String
Una cadena con formato compuesto (ver Comentarios) que contiene texto mezclado con cero o varios elementos de formato, que corresponden a objetos de la matriz args.
args
Tipo: System.Object[]
Matriz de object que contiene cero o más objetos a los que se va a dar formato.

ExcepciónCondición
ArgumentNullException

format es null.

FormatException

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.

ObjectDisposedException

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

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

El método TraceEvent sirve para realizar un seguimiento de los eventos que se pueden procesar automáticamente mediante herramientas. Por ejemplo, una herramienta de supervisión puede notificar a un administrador si un origen concreto realiza el seguimiento de un evento específico.

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

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

NotaNota

El objeto EventLogTraceListener se limita a un valor máximo id de 65.535. Si el valor especificado en id es mayor de 65.535, el objeto EventLogTraceListener usa 65.535.

En el ejemplo de código siguiente se muestra el uso del método TraceEvent(TraceEventType, Int32) para pasar un evento de seguimiento a los agentes de escucha. Este ejemplo de código forma parte de un ejemplo más extenso referente a 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");


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft