TraceListener.TraceTransfer Method (TraceEventCache, String, Int32, String, Guid)

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Writes trace information, a message, a related activity identity and event information to the listener specific output.

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

C#
C++
F#
VB
Copy 
<ComVisibleAttribute(False)>
Public Overridable Sub TraceTransfer (
	eventCache As TraceEventCache,
	source As String,
	id As Integer,
	message As String,
	relatedActivityId As Guid
)

Parameters

eventCache
Type: System.Diagnostics.TraceEventCache

A TraceEventCache object that contains the current process ID, thread ID, and stack trace information.

source
Type: System.String

A name used to identify the output, typically the name of the application that generated the trace event.

id
Type: System.Int32

A numeric identifier for the event.

message
Type: System.String

A message to write.

relatedActivityId
Type: System.Guid

A Guid object identifying a related activity.

System_CAPS_importantImportant

This method is not intended to be called directly by application code but by members of the Debug, Trace, and TraceSource classes to write trace data to output.

The TraceTransfer method is used for the correlation of related traces. The TraceTransfer method calls the TraceEvent method to process the call, with the eventType level set to Transfer and the relatedActivityIdGuid as a string appended to the message.

.NET Framework
Available since 2.0
Return to top
Show: