TraceSource.TraceTransfer(Int32, String, Guid) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitmember this.TraceTransfer : int * string * Guid -> unitPublic 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.
