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

relatedActivityId

Guid

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

eventPayload

Object[]

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

傳回

Boolean

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

屬性

SecurityCriticalAttribute

例外狀況

ArgumentException

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

備註

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

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

relatedActivityId

Guid

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

dataCount

Int32

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

data

IntPtr

nativeint

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

傳回

Boolean

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

屬性

SecurityCriticalAttribute

備註

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