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處理呼叫的方法，將 設定TraceListener.TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)eventType為 ，並將 GUID 的字串表示TraceEventType.Transfer附加於 relatedActivityId。message
TraceTransfer 設計用於邏輯運算 CorrelationManager。 參數 relatedActivityId 與 ActivityId 物件的性質 CorrelationManager 相關。 若邏輯操作從一個活動開始並轉移到另一個活動，第二個活動會透過呼叫該 TraceTransfer 方法來記錄該傳輸。 呼叫 TraceTransfer 將新的活動身份與先前的身份聯繫起來。 此功能最可能的使用者是能報告跨越多個活動的邏輯操作的追蹤檢視器。
