EventListener Sınıf

Tanım

Ad Alanı:

System.Diagnostics.Tracing

Bütünleştirilmiş Kod:

System.Diagnostics.Tracing.dll

Kaynak:

EventSource.cs

Olay kaynaklarından olayları etkinleştirmeye ve devre dışı bırakmaya yönelik yöntemler sağlar.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Devralma

Object

EventListener

Uygulamalar

IDisposable

Açıklamalar

Olay dinleyicisi, geçerli uygulama etki alanındaki olay kaynağı (EventSource nesne) uygulamaları tarafından oluşturulan tüm olaylar için hedefi temsil eder. Yeni bir olay dinleyicisi oluşturulduğunda, bu uygulama etki alanındaki tüm olay kaynaklarına mantıksal olarak eklenir.

Not

Bu tür arabirimini IDisposable uygular. Türünü kullanmayı bitirdiğinizde, doğrudan veya dolaylı olarak atmalısınız. Türü doğrudan atmak için yöntemini bir try/catch blokta çağırın.Dispose Bunu dolaylı olarak atmak için (C#'ta) veya Using (Visual Basic'te) gibi using bir dil yapısı kullanın. Daha fazla bilgi için arabirim konusunun "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne IDisposable bakın.

Olay dinleyicisi, dinleyiciye gönderilecek olay kümesini daha fazla kısıtlamak için olay düzeylerini (EventLevel) ve olay anahtar sözcüklerini (EventKeywords) kullanarak geçerli olay kaynağı temelinde etkinleştirebilir veya devre dışı bırakabilir. Dinleyici, yöntemini kullanarak SendCommand belirli bir geçerli olay kaynağına rastgele komutlar da gönderebilir. Komutların anlamları olay kaynağının uygulanmasına özeldir.

Tek bir uygulama etki alanında birden çok olay dinleyicisi tanımlanabilir. Her dinleyici diğer dinleyicilerden mantıksal olarak bağımsızdır, böylece bir dinleyici tarafından etkinleştirilen veya devre dışı bırakılan olaylar yalnızca o dinleyiciyi etkiler. yöntemiyle gönderilen komutların SendCommand diğer dinleyicileri etkileyen bir semantik işlem (çöp toplama veya verileri boşaltma gibi) yapması mümkündür, ancak kural yerine bu özel durumdur.

Her olay kaynağı, olayları gönderdiği olay dinleyicilerinin listesini tutar. Her olay kaynak dinleyicisi çiftiyle bir dizi filtreleme ölçütü ilişkilendirilir. Bu ölçütler dinleyicinin geçerli olay kaynağı için alacağı olayları belirler. Dinleyiciler kendi yöntemlerinde OnEventWritten olayları alır. Bu nedenle, verilerle yararlı bir şey yapmak için alt sınıflarının EventListener bu yöntemi geçersiz kılması gerekir.

Yeni bir olay kaynağı oluşturulduğunda OnEventSourceCreated yöntemi çağrılır. Her geçerli olay dinleyicisi, günlük iletileri gönderebilen her geçerli olay kaynağı için tam olarak bir OnEventSourceCreated çağrı alır. Bir olay dinleyicisi oluşturulduğunda, dinleyici oluşturulmadan önce var olan tüm olay kaynaklarını yeni dinleyiciye bildirmek için bir dizi OnEventSourceCreated çağrı yapılır.

Önemli

Örneği EventListeneroluştururken, oluşturucu tamamlanmadan önce ve OnEventWritten öğesine geri OnEventSourceCreated çağrı yapılabilir. Bu geri çağırmalarda kullanılan örnek üyelerini başlatırken dikkatli olun.

Oluşturucular

EventListener()

EventListener sınıfının yeni bir örneğini oluşturur.

Yöntemler

DisableEvents(EventSource)	Belirtilen olay kaynağı için tüm olayları devre dışı bırakır.
Dispose()	EventListener sınıfının geçerli örneği tarafından kullanılan kaynakları serbest bırakır.
EnableEvents(EventSource, EventLevel)	Belirtilen ayrıntı düzeyi veya daha düşük olan belirtilen olay kaynağı için olayları etkinleştirir.
EnableEvents(EventSource, EventLevel, EventKeywords)	Belirtilen ayrıntı düzeyi veya daha düşük olan belirtilen olay kaynağı için olayları ve eşleşen anahtar sözcük bayraklarını etkinleştirir.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Belirtilen ayrıntı düzeyi veya daha düşük, eşleşen olay anahtar sözcüğü bayrağı ve eşleşen bağımsız değişkenlere sahip belirtilen olay kaynağı için olayları etkinleştirir.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
EventSourceIndex(EventSource)	Belirtilen olay kaynağını temsil eden negatif olmayan küçük bir sayı alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnEventSourceCreated(EventSource)	Olay dinleyicisi oluşturulduğunda ve dinleyiciye yeni bir olay kaynağı eklendiğinde mevcut tüm olay kaynakları için çağrılır.
OnEventWritten(EventWrittenEventArgs)	Olay dinleyicisinin olayları etkinleştirdiği bir olay kaynağı tarafından her olay yazıldığı zaman çağrılır.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ekinlikler

EventSourceCreated	Dağıtıcıya bir olay kaynağı (EventSource nesne) eklendiğinde gerçekleşir.
EventWritten	Olay dinleyicisinin olayları etkinleştirdiği bir olay kaynağı (EventSource nesne) tarafından bir olay yazıldığında gerçekleşir.