EventProvider.WriteTransferEvent 方法

定义

命名空间:

System.Diagnostics.Eventing

程序集:

System.Core.dll

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

重载

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 减去事件头大小所得的值。 如果会话的缓冲区较小，而且会话中包括事件的扩展数据项，则该事件会较小。

返回

Boolean

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

属性

SecurityCriticalAttribute

例外

ArgumentException

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

注解

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

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

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

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

返回

Boolean

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

属性

SecurityCriticalAttribute

注解

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