共用方式為


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 的執行個體 (Instance),其識別要寫入的事件。

relatedActivityId
Guid

上一個元件中的活動識別項。 請使用此參數將元件的事件連結到上一個元件的事件。

eventPayload
Object[]

包含要寫入之事件資料的物件陣列。 資料必須按照資訊清單中指定的順序排列。 此陣列最多只能有 32 個物件,而且其中只能有 8 個字串。 事件資料大小上限為 64 KB 減去事件標頭大小。 如果工作階段的緩衝區大小較小且包含延伸的資料項目與事件,則事件大小較小。

傳回

如果已寫入事件則為 true,否則為 false。 若為 false,請呼叫 GetLastWriteEventError() 方法,判斷失敗的原因。

屬性

例外狀況

如果 eventPayload 包含太多物件或字串。

備註

方法會使用線程內容中設定的活動標識碼來識別此元件。 若要設定活動標識碼,請呼叫 SetActivityId 方法。

如果您使用 類別 Trace ,則不會使用 SetActivityId 方法來指定活動識別碼。 請改為存取 CorrelationManager 屬性以取得 CorrelationManager 物件。 然後,將 ActivityId 屬性設定為活動標識碼。 您也必須將 設定 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 的執行個體 (Instance),其識別要寫入的事件。

relatedActivityId
Guid

上一個元件中的活動識別項。 請使用此參數將元件的事件連結到上一個元件的事件。

dataCount
Int32

data 參數所指向之事件資料的大小。 事件資料大小上限為 64 KB 減去事件標頭大小。 如果工作階段的緩衝區大小較小且包含延伸的資料項目與事件,則事件大小較小。

data
IntPtr

nativeint

要寫入之事件資料的指標。

傳回

如果已寫入事件則為 true,否則為 false。 若為 false,請呼叫 GetLastWriteEventError() 方法,判斷失敗的原因。

屬性

備註

方法會使用線程內容中設定的活動標識碼來識別此元件。 若要設定活動標識碼,請呼叫 SetActivityId 方法。

適用於