EventProvider.WriteTransferEvent 方法

定义

在端到端方案中跟踪事件时将多个事件链接在一起。

重载

WriteTransferEvent(EventDescriptor, Guid, Object[])

在端到端方案中跟踪事件时将多个事件链接在一起。 以对象数组形式指定事件数据。

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

在端到端方案中跟踪事件时将多个事件链接在一起。 以内存块形式指定事件数据。

WriteTransferEvent(EventDescriptor, Guid, Object[])

在端到端方案中跟踪事件时将多个事件链接在一起。 以对象数组形式指定事件数据。

public:
 bool WriteTransferEvent(System::Diagnostics::Eventing::EventDescriptor % eventDescriptor, Guid relatedActivityId, ... cli::array <System::Object ^> ^ eventPayload);
[System.Security.SecurityCritical]
public bool WriteTransferEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, Guid relatedActivityId, params object[] eventPayload);
[<System.Security.SecurityCritical>]
member this.WriteTransferEvent : EventDescriptor * Guid * obj[] -> bool
Public Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, ParamArray eventPayload As Object()) As Boolean

参数

eventDescriptor
EventDescriptor

用来标识要写入的事件的 EventDescriptor 实例。

relatedActivityId
Guid

上一个组件的活动标识符。 使用该参数可以将您的组件的事件链接到上一个组件的事件。

eventPayload
Object[]

包含要写入的事件数据的对象数组。 该数据必须采用清单中所指定的顺序。 该数组限制为 32 个对象,其中只有八个对象可以是字符串。 事件数据的最大大小限制为 64 KB 减去事件头大小所得的值。 如果会话的缓冲区较小,而且会话中包括事件的扩展数据项,则该事件会较小。

返回

如果写入此事件,则为 true;否则为 false。 如果为 false,则调用 GetLastWriteEventError() 方法来确定失败的原因。

属性

例外

如果 eventPayload 包含的对象或字符串太多。

注解

方法使用线程上下文中设置的活动 ID 来标识此组件。 若要设置活动 ID,请调用 SetActivityId 方法。

如果使用 Trace 类,则不要使用 SetActivityId 方法来指定活动 ID。 而是访问 CorrelationManager 属性以获取 CorrelationManager 对象。 然后,将 ActivityId 属性设置为活动 ID。 还必须将 设置为relatedActivityIdActivityId值。

适用于

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

在端到端方案中跟踪事件时将多个事件链接在一起。 以内存块形式指定事件数据。

protected:
 bool WriteTransferEvent(System::Diagnostics::Eventing::EventDescriptor % eventDescriptor, Guid relatedActivityId, int dataCount, IntPtr data);
[System.Security.SecurityCritical]
protected bool WriteTransferEvent (ref System.Diagnostics.Eventing.EventDescriptor eventDescriptor, Guid relatedActivityId, int dataCount, IntPtr data);
[<System.Security.SecurityCritical>]
member this.WriteTransferEvent : EventDescriptor * Guid * int * nativeint -> bool
Protected Function WriteTransferEvent (ByRef eventDescriptor As EventDescriptor, relatedActivityId As Guid, dataCount As Integer, data As IntPtr) As Boolean

参数

eventDescriptor
EventDescriptor

用来标识要写入的事件的 EventDescriptor 实例。

relatedActivityId
Guid

上一个组件的活动标识符。 使用该参数可以将您的组件的事件链接到上一个组件的事件。

dataCount
Int32

data 参数所指向的事件数据的大小。 事件数据的最大大小限制为 64 KB 减去事件头大小所得的值。 如果会话的缓冲区较小,而且会话中包括事件的扩展数据项,则该事件会较小。

data
IntPtr

nativeint

指向要写入的事件数据的指针。

返回

如果写入此事件,则为 true;否则为 false。 如果为 false,则调用 GetLastWriteEventError() 方法来确定失败的原因。

属性

注解

方法使用线程上下文中设置的活动 ID 来标识此组件。 若要设置活动 ID,请调用 SetActivityId 方法。

适用于