TraceSource.TraceTransfer(Int32, String, Guid) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用指定的數值識別項、訊息和相關的活動識別項，將追蹤傳輸訊息寫入至 Listeners 集合中的追蹤接聽程式。
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)參數
- id
- Int32
事件的數值識別項。
- message
- String
要寫入的追蹤訊息。
- relatedActivityId
- Guid
識別相關活動的結構。
- 屬性
備註
方法 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 會將新的活動身分識別與先前的身分識別產生關聯。 這項功能最有可能的取用者是追蹤查看器，可報告跨越多個活動的邏輯作業。
