Kelas System.Diagnostics.Tracing.EventWrittenEventArgs

Artikel ini menyediakan keterangan tambahan untuk dokumentasi referensi untuk API ini.

Kelas EventWrittenEventArgs menyediakan data untuk OnEventWritten panggilan balik.

Setiap kali peristiwa dikirim ke EventListener, EventListener.OnEventWritten metode panggilan balik dipanggil. Ini diteruskan instans EventWrittenEventArgs yang berisi informasi yang terkait dengan peristiwa. Semua nilai EventWrittenEventArgs properti kelas hanya valid selama panggilan balik.

Bagian berikut berisi informasi tambahan tentang properti individual EventWrittenEventArgs .

Properti ActivityId

Saat menggunakan System.Activities.Activity dan kelas turunannya, utas dapat ditandai sebagai memiliki aktivitas yang terkait dengannya. Properti ActivityId mengembalikan ID aktivitas utas yang mencatat peristiwa. Perhatikan bahwa utas tidak harus memiliki aktivitas, dalam hal ini properti ini mengembalikan Guid.Empty.

Properti OSThreadId dan TimeStamp

Dimulai dengan .NET Core 2.2, EventListener objek dapat berlangganan peristiwa runtime asli (seperti peristiwa GC, JIT, dan threadpool) selain peristiwa yang dipancarkan oleh EventSource objek. Dalam versi .NET Core sebelumnya dan semua versi .NET Framework, ID utas dan tanda waktu dapat dikumpulkan dari lingkungan, karena dikirim secara sinkron pada utas yang sama yang memancarkannya. Namun, tidak semua peristiwa runtime asli dapat dikirim secara sinkron. Beberapa peristiwa, seperti peristiwa GC, dipancarkan ketika eksekusi utas terkelola ditangguhkan. Peristiwa ini di-buffer dalam kode asli dan dikirim oleh utas dispatcher setelah kode terkelola dapat dijalankan lagi. Karena peristiwa ini di-buffer, lingkungan tidak dapat digunakan untuk mengambil ID utas dan tanda waktu dengan andal. Karena itu, dimulai dengan .NET Core 2.2, ID utas dan informasi tanda waktu tersedia sebagai anggota EventWrittenEventArgs kelas.

Properti RelatedActivityId

Aktivitas terkait adalah aktivitas yang sangat terkait dengan aktivitas saat ini. Biasanya, itu adalah aktivitas yang menyebabkan aktivitas saat ini (peristiwa dengan Start opcode biasanya melakukan ini) atau aktivitas yang dibuat oleh yang saat ini (peristiwa dengan Send opcode biasanya melakukan ini). Ketika digunakan, RelatedActivityID secara eksplisit diteruskan oleh metode yang melakukan pengelogan. Banyak peristiwa tidak meneruskan RelatedActivityId, dalam hal ini properti ini mengembalikan Guid.Empty.