EventProvider.WriteTransferEvent 方法

参考

定义

命名空间:: System.Diagnostics.Eventing

程序集:: System.Core.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

重载

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。还必须将设置为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