EventListener Kelas

Definisi

Ruang nama:

System.Diagnostics.Tracing

Rakitan:

System.Diagnostics.Tracing.dll

Sumber:

EventSource.cs

Menyediakan metode untuk mengaktifkan dan menonaktifkan peristiwa dari sumber peristiwa.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Warisan

Object

EventListener

Penerapan

IDisposable

Keterangan

Pendengar peristiwa mewakili target untuk semua peristiwa yang dihasilkan oleh implementasi sumber peristiwa (EventSource objek) di domain aplikasi saat ini. Saat pendengar peristiwa baru dibuat, pendengar peristiwa secara logis dilampirkan ke semua sumber peristiwa di domain aplikasi tersebut.

Catatan

Jenis ini mengimplementasikan IDisposable antarmuka. Setelah selesai menggunakan jenis tersebut, Anda harus membuangnya baik secara langsung maupun tidak langsung. Untuk membuang jenis secara langsung, panggil metodenya Dispose dalam try/catch blok. Untuk membuangnya secara tidak langsung, gunakan konstruksi bahasa seperti using (dalam C#) atau Using (di Visual Basic). Untuk informasi selengkapnya, lihat bagian "Menggunakan Objek yang Mengimplementasikan IDisposable" dalam IDisposable topik antarmuka.

Pendengar peristiwa dapat mengaktifkan atau menonaktifkan berdasarkan sumber peristiwa per saat ini dengan menggunakan tingkat peristiwa (EventLevel) dan kata kunci peristiwa (EventKeywords) untuk lebih membatasi kumpulan peristiwa yang akan dikirim ke pendengar. Pendengar juga dapat mengirim perintah arbitrer ke sumber peristiwa tertentu saat ini dengan menggunakan SendCommand metode . Arti perintah khusus untuk implementasi sumber peristiwa.

Beberapa pendengar peristiwa dapat didefinisikan dalam satu domain aplikasi. Setiap pendengar secara logis independen dari pendengar lain sehingga peristiwa yang diaktifkan atau dinonaktifkan oleh satu pendengar hanya memengaruhi pendengar tersebut. Dimungkinkan bagi perintah yang dikirim dengan SendCommand metode untuk melakukan operasi semantik (seperti pengumpulan sampah atau data pembilasan) yang memengaruhi pendengar lain, tetapi ini adalah pengecualian daripada aturan.

Setiap sumber kejadian menyimpan daftar pendengar peristiwa tempatnya mengirim peristiwa. Sekumpulan kriteria pemfilteran dikaitkan dengan setiap pasangan pendengar sumber peristiwa. Kriteria ini menentukan peristiwa yang akan diterima pendengar untuk sumber peristiwa saat ini. Pendengar menerima peristiwa pada metode mereka OnEventWritten . Oleh karena itu, subkelas EventListener harus mengambil alih metode ini untuk melakukan sesuatu yang berguna dengan data.

Saat sumber peristiwa baru dibuat, OnEventSourceCreated metode dipanggil. Setiap pendengar peristiwa saat ini mendapatkan tepat satu OnEventSourceCreated panggilan untuk setiap sumber peristiwa saat ini yang dapat mengiriminya pesan log. Saat pendengar peristiwa dibuat, serangkaian OnEventSourceCreated panggilan dilakukan untuk memberi tahu pendengar baru tentang semua sumber peristiwa yang ada sebelum pendengar dibuat.

Penting

Saat membuat EventListenerinstans , panggilan balik ke OnEventSourceCreated dan OnEventWritten dapat terjadi sebelum konstruktor selesai. Berhati-hatilah saat Anda menginisialisasi anggota instans yang digunakan dalam panggilan balik tersebut.

Konstruktor

EventListener()

Membuat instans EventListener baru kelas.

Metode

DisableEvents(EventSource)	Menonaktifkan semua peristiwa untuk sumber kejadian yang ditentukan.
Dispose()	Merilis sumber daya yang digunakan oleh instans EventListener kelas saat ini.
EnableEvents(EventSource, EventLevel)	Mengaktifkan peristiwa untuk sumber peristiwa yang ditentukan yang memiliki tingkat verbositas yang ditentukan atau lebih rendah.
EnableEvents(EventSource, EventLevel, EventKeywords)	Mengaktifkan peristiwa untuk sumber peristiwa yang ditentukan yang memiliki tingkat verbositas yang ditentukan atau lebih rendah, dan bendera kata kunci yang cocok.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Mengaktifkan peristiwa untuk sumber peristiwa yang ditentukan yang memiliki tingkat verbositas yang ditentukan atau lebih rendah, bendera kata kunci peristiwa yang cocok, dan argumen yang cocok.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
EventSourceIndex(EventSource)	Mendapatkan angka kecil non-negatif yang mewakili sumber peristiwa yang ditentukan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
OnEventSourceCreated(EventSource)	Dipanggil untuk semua sumber peristiwa yang ada saat pendengar peristiwa dibuat dan ketika sumber peristiwa baru dilampirkan ke pendengar.
OnEventWritten(EventWrittenEventArgs)	Dipanggil setiap kali peristiwa ditulis oleh sumber peristiwa tempat pendengar peristiwa mengaktifkan peristiwa.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Acara

EventSourceCreated	Terjadi ketika sumber peristiwa (EventSource objek) dilampirkan ke dispatcher.
EventWritten	Terjadi ketika peristiwa telah ditulis oleh sumber peristiwa (EventSource objek) tempat pendengar peristiwa telah mengaktifkan peristiwa.