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

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

Source:

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) 方法来处理调用，将 设置为 eventTypeTraceEventType.Transfer ，并将 GUID 的relatedActivityId字符串表示形式追加到 message。TraceListener

TraceTransfer 旨在与 的逻辑操作一 CorrelationManager起使用。 参数 relatedActivityId 与 ActivityId 对象的 属性 CorrelationManager 相关。 如果逻辑操作在一个活动中开始并传输到另一个活动，则第二个活动通过调用 TraceTransfer 方法记录传输。 调用 TraceTransfer 将新活动标识与以前的标识相关联。 此功能最有可能使用者是跟踪查看器，它可以报告跨多个活动的逻辑操作。

另请参阅

• XmlWriterTraceListener
• EventSchemaTraceListener
• DelimitedListTraceListener