This documentation is archived and is not being maintained.

TraceSource.TraceData Method (TraceEventType, Int32, Object[])

Writes trace data to the trace listeners in the Listeners collection using the specified event type, event identifier, and trace data array.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

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



One of the TraceEventType values that specifies the event type of the trace data.


A numeric identifier for the event.


An object array containing the trace data.

Exception typeCondition


An attempt was made to trace an event during finalization.

The TraceData method, like the TraceEvent method, is intended for automated tools, but it also allows the attaching of additional objects, such as an exception instance and a stack trace, to the trace.

The TraceData method calls the ShouldTrace method of the SourceSwitch object returned by the Switch property. If ShouldTrace returns true, TraceData calls the corresponding TraceData method on all listeners. Otherwise, TraceData returns without calling the listeners' methods.


The EventLogTraceListener object is limited to a maximum id value of 65,535. If the id value specified is greater than 65,535, the EventLogTraceListener object uses 65,535.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0