EventProvider.WriteTransferEvent Metode

Definisi

Ruang nama:

System.Diagnostics.Eventing

Rakitan:

System.Core.dll

Menautkan peristiwa bersama-sama saat melacak peristiwa dalam skenario end-to-end.

Overload

WriteTransferEvent(EventDescriptor, Guid, Object[])	Menautkan peristiwa bersama-sama saat melacak peristiwa dalam skenario end-to-end. Data peristiwa ditentukan sebagai array objek.
WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)	Menautkan peristiwa bersama-sama saat melacak peristiwa dalam skenario end-to-end. Data peristiwa ditentukan sebagai blok memori.

WriteTransferEvent(EventDescriptor, Guid, Object[])

Menautkan peristiwa bersama-sama saat melacak peristiwa dalam skenario end-to-end. Data peristiwa ditentukan sebagai array objek.

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

Parameter

eventDescriptor

EventDescriptor

Instans EventDescriptor yang mengidentifikasi peristiwa yang akan ditulis.

relatedActivityId

Guid

Pengidentifikasi aktivitas dari komponen sebelumnya. Gunakan parameter ini untuk menautkan peristiwa komponen Anda ke peristiwa komponen sebelumnya.

eventPayload

Object[]

Array objek yang berisi data peristiwa untuk ditulis. Data harus dalam urutan yang ditentukan dalam manifes. Array dibatasi hingga 32 objek, di mana hanya delapan yang mungkin berupa string. Ukuran data maksimum untuk peristiwa dibatasi hingga 64 KB dikurangi ukuran header peristiwa. Ukuran peristiwa lebih kecil jika ukuran buffer sesi kurang dan sesi menyertakan item data yang diperluas dengan peristiwa tersebut.

Mengembalikan

Boolean

Apakah true jika peristiwa ditulis; jika tidak, false. Jika false, panggil GetLastWriteEventError() metode untuk menentukan penyebab kegagalan.

Atribut

SecurityCriticalAttribute

Pengecualian

ArgumentException

Jika eventPayload berisi terlalu banyak objek atau string.

Keterangan

Metode ini menggunakan ID aktivitas yang ditetapkan dalam konteks utas untuk mengidentifikasi komponen ini. Untuk mengatur ID aktivitas, panggil SetActivityId metode .

Jika Anda menggunakan Trace kelas , Anda tidak menggunakan SetActivityId metode untuk menentukan ID aktivitas. Sebagai gantinya CorrelationManager , akses properti untuk mendapatkan CorrelationManager objek . Kemudian, atur ActivityId properti ke ID aktivitas. Anda juga harus mengatur ke relatedActivityIdActivityId nilai.

WriteTransferEvent(EventDescriptor, Guid, Int32, IntPtr)

Menautkan peristiwa bersama-sama saat melacak peristiwa dalam skenario end-to-end. Data peristiwa ditentukan sebagai blok memori.

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

Parameter

eventDescriptor

EventDescriptor

Instans EventDescriptor yang mengidentifikasi peristiwa yang akan ditulis.

relatedActivityId

Guid

Pengidentifikasi aktivitas dari komponen sebelumnya. Gunakan parameter ini untuk menautkan peristiwa komponen Anda ke peristiwa komponen sebelumnya.

dataCount

Int32

Ukuran data peristiwa tempat parameter menunjuk data . Ukuran data peristiwa maksimum dibatasi hingga 64 KB dikurangi ukuran header peristiwa. Ukuran peristiwa lebih kecil jika ukuran buffer sesi kurang dan sesi menyertakan item data yang diperluas dengan peristiwa tersebut.

data

IntPtr

nativeint

Arahkan ke data peristiwa untuk ditulis.

Mengembalikan

Boolean

Apakah true jika peristiwa ditulis; jika tidak, false. Jika false, panggil GetLastWriteEventError() metode untuk menentukan penyebab kegagalan.

Atribut

SecurityCriticalAttribute

Keterangan

Metode ini menggunakan ID aktivitas yang ditetapkan dalam konteks utas untuk mengidentifikasi komponen ini. Untuk mengatur ID aktivitas, panggil SetActivityId metode .