TraceListener.TraceTransfer Method

Definition

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

public:
 virtual void TraceTransfer(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, int id, System::String ^ message, Guid relatedActivityId);
public virtual void TraceTransfer (System.Diagnostics.TraceEventCache? eventCache, string source, int id, string? message, Guid relatedActivityId);
public virtual void TraceTransfer (System.Diagnostics.TraceEventCache eventCache, string source, int id, string message, Guid relatedActivityId);
[System.Runtime.InteropServices.ComVisible(false)]
public virtual void TraceTransfer (System.Diagnostics.TraceEventCache eventCache, string source, int id, string message, Guid relatedActivityId);
abstract member TraceTransfer : System.Diagnostics.TraceEventCache * string * int * string * Guid -> unit
override this.TraceTransfer : System.Diagnostics.TraceEventCache * string * int * string * Guid -> unit
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member TraceTransfer : System.Diagnostics.TraceEventCache * string * int * string * Guid -> unit
override this.TraceTransfer : System.Diagnostics.TraceEventCache * string * int * string * Guid -> unit
Public Overridable Sub TraceTransfer (eventCache As TraceEventCache, source As String, id As Integer, message As String, relatedActivityId As Guid)

Parameters

eventCache
TraceEventCache

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

source
String

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

id
Int32

A numeric identifier for the event.

message
String

A message to write.

relatedActivityId
Guid

A Guid object identifying a related activity.

Attributes

Remarks

Important

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 relatedActivityId Guid as a string appended to the message.

Applies to

See also