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 -> unit
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
标识相关活动的结构。
- 属性
注解
方法 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 将新活动标识与以前的标识相关联。 此功能最有可能使用者是跟踪查看器,它可以报告跨多个活动的逻辑操作。