EventSchemaTraceListener.TraceTransfer Methode

Definition

Schreibt Ablaufverfolgungsinformationen, darunter die Identität einer verwandten Aktivität, eine Meldung sowie Ereignisinformationen, in die Protokolldatei.

public:
 override void TraceTransfer(System::Diagnostics::TraceEventCache ^ eventCache, System::String ^ source, int id, System::String ^ message, Guid relatedActivityId);
[System.Security.SecurityCritical]
public override void TraceTransfer (System.Diagnostics.TraceEventCache eventCache, string source, int id, string message, Guid relatedActivityId);
[<System.Security.SecurityCritical>]
override this.TraceTransfer : System.Diagnostics.TraceEventCache * string * int * string * Guid -> unit
Public Overrides Sub TraceTransfer (eventCache As TraceEventCache, source As String, id As Integer, message As String, relatedActivityId As Guid)

Parameter

eventCache
TraceEventCache

Ein TraceEventCache mit der aktuellen Prozess-ID, Thread-ID und den aktuellen Stapelüberwachungsinformationen.

source
String

Der Quellenname.

id
Int32

Ein numerischer Bezeichner für das Ereignis.

message
String

Eine zu schreibende Ablaufverfolgungsmeldung.

relatedActivityId
Guid

Eine Guid-Struktur, die eine verwandte Aktivität bezeichnet.

Attribute

Hinweise

Die TraceTransfer -Methode wird verwendet, um verwandte Ablaufverfolgungen zu korrelieren. Die eventCacheParameter , source, idund relatedActivityId werden in der Kopf- und Fußzeile der Ablaufverfolgung verwendet. Der id Parameter wird in eine ganze Zahl ohne Vorzeichen konvertiert, bevor er geschrieben wird. Daher wird ein negativer id Wert als große positive ganze Zahl geschrieben. Der message Parameter wird als - Data Element geschrieben. Die Guid.ToString(String) -Methode wird aufgerufen, um den relatedActivityId Wert in eine Zeichenfolge im Format "B" zu konvertieren, die im Header angezeigt wird. Das Opcode Element in der Fußzeile identifiziert den Ablaufverfolgungsereignistyp Transferals .

Wichtig

Die TraceTransfer -Methode sollte nicht vom Anwendungscode aufgerufen werden. Sie soll von einem TraceSource -Objekt verwendet werden, um die Ablaufverfolgungsinformationen für die TraceTransfer -Methode ausgibt.

Gilt für: