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 的執行個體 (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

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

傳回