TraceSource.TraceTransfer(Int32, String, Guid) Methode

Definition

Schreibt eine Meldung der Ablaufverfolgungsübertragung in die Ablaufverfolgungslistener der Listeners-Auflistung. Hierbei werden der angegebene numerische Bezeichner, die Meldung und der verwandte Aktivitätsbezeichner verwendet.

public:
 void TraceTransfer(int id, System::String ^ message, Guid relatedActivityId);
[System.Diagnostics.Conditional("TRACE")]
public void TraceTransfer (int id, string? message, Guid relatedActivityId);
public void TraceTransfer (int id, string message, Guid relatedActivityId);
[System.Diagnostics.Conditional("TRACE")]
public void TraceTransfer (int id, string message, Guid relatedActivityId);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceTransfer : int * string * Guid -> unit
member this.TraceTransfer : int * string * Guid -> unit
Public Sub TraceTransfer (id As Integer, message As String, relatedActivityId As Guid)

Parameter

id
Int32

Ein numerischer Bezeichner für das Ereignis.

message
String

Die zu schreibende Ablaufverfolgungsmeldung.

relatedActivityId
Guid

Eine Struktur, die die verwandte Aktivität bezeichnet.

Attribute

Hinweise

Die TraceTransfer -Methode ruft die TraceTransfer Methode jedes Ablaufverfolgungslisteners in der Listeners -Eigenschaft auf, um die Ablaufverfolgungsinformationen zu schreiben. Die Standardmethode TraceTransfer in der Basisklasse TraceListener ruft die TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) -Methode auf, um den Aufruf zu verarbeiten, wobei eine Zeichenfolgendarstellung der relatedActivityId GUID an TraceEventType.Transfer festgelegt eventType und angefügt wirdmessage.

TraceTransfer ist für die Verwendung mit den logischen Vorgängen eines CorrelationManagervorgesehen. Der relatedActivityId Parameter bezieht sich auf die ActivityId -Eigenschaft eines CorrelationManager -Objekts. Wenn ein logischer Vorgang in einer Aktivität beginnt und an eine andere übertragen wird, protokolliert die zweite Aktivität die Übertragung, indem die TraceTransfer -Methode aufgerufen wird. Der TraceTransfer Aufruf bezieht die neue Aktivitätsidentität auf die vorherige Identität. Der wahrscheinlichste Consumer dieser Funktionalität ist ein Ablaufverfolgungs-Viewer, der logische Vorgänge melden kann, die mehrere Aktivitäten umfassen.

Gilt für:

Weitere Informationen