Esta documentación está archivada y no tiene mantenimiento.

TraceSource.TraceData (Método) (TraceEventType, Int32, Object)

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

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

[ConditionalAttribute("TRACE")] 
public void TraceData (
	TraceEventType eventType,
	int id,
	Object data
)
/** @attribute ConditionalAttribute("TRACE") */ 
public void TraceData (
	TraceEventType eventType, 
	int id, 
	Object data
)
ConditionalAttribute("TRACE") 
public function TraceData (
	eventType : TraceEventType, 
	id : int, 
	data : Object
)
No aplicable.

Parámetros

eventType

Uno de los valores de TraceEventType que especifica el tipo de evento de los datos de seguimiento.

id

Identificador numérico para el evento.

data

Datos de seguimiento.

El método TraceData, al igual que el método TraceEvent, va dirigido a las herramientas automatizadas, pero también permite adjuntar al seguimiento un objeto adicional, como una instancia de excepción.

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

NotaNota:

La clase EventLogTraceListener está limitada a un valor de id máximo igual a 65.535. Si el valor de id especificado es mayor que 65.535, EventLogTraceListener utiliza el máximo valor permitido.

En el ejemplo de código siguiente se muestra el uso del método TraceData(TraceEventType,Int32,Object) para filtrar y enviar un mensaje 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.

// Test the filter on the ConsoleTraceListener.
ts.Listeners["console"].Filter = new SourceFilter("No match");
ts.TraceData(TraceEventType.Error, 5,
    "SourceFilter should reject this message for the console trace listener.");
ts.Listeners["console"].Filter = new SourceFilter("TraceTest");
ts.TraceData(TraceEventType.Error, 6,
    "SourceFilter should let this message through on the console trace listener.");

Windows 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: