TraceSource.TraceTransfer(Int32, String, Guid) 方法

定義

命名空間:

System.Diagnostics

組件:

System.Diagnostics.TraceSource.dll

來源:

TraceSource.cs

使用指定的數值識別項、訊息和相關的活動識別項，將追蹤傳輸訊息寫入至 Listeners 集合中的追蹤接聽程式。

public:
 void TraceTransfer(int id, System::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

Public Sub TraceTransfer (id As Integer, message As String, relatedActivityId As Guid)

參數

id

Int32

事件的數值識別項。

message

String

要寫入的追蹤訊息。

relatedActivityId

Guid

識別相關活動的結構。

屬性

ConditionalAttribute

備註

方法 TraceTransfer 會 TraceTransfer 呼叫 屬性中 Listeners 每個追蹤接聽程式的方法，以寫入追蹤資訊。 基類中的預設TraceTransfer方法會TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)呼叫 方法來處理呼叫、將 設定eventType為 TraceEventType.Transfer ，並將 GUID 的relatedActivityId字串表示附加至 message。TraceListener

TraceTransfer 是要與的 CorrelationManager邏輯作業搭配使用。 參數 relatedActivityId 與 ActivityId 對象的 屬性 CorrelationManager 相關。 如果邏輯作業從某個活動開始，並傳輸至另一個活動，則第二個活動會藉由呼叫 TraceTransfer 方法來記錄傳輸。 呼叫 TraceTransfer 會將新的活動身分識別與先前的身分識別產生關聯。 這項功能最有可能的取用者是追蹤查看器，可報告跨越多個活動的邏輯作業。

另請參閱

• XmlWriterTraceListener
• EventSchemaTraceListener
• DelimitedListTraceListener