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)

[ConditionalAttribute("TRACE")]
public void TraceData(
	TraceEventType eventType,
	int id,
	params Object[] data
)

Parameters

eventType
Type: System.Diagnostics.TraceEventType

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

id
Type: System.Int32

A numeric identifier for the event.

data
Type: System.Object[]

An object array containing the trace data.

ExceptionCondition
ObjectDisposedException

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.

NoteNote

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.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft