EventListener Sınıf

Tanım

Ad Alanı:

System.Diagnostics.Tracing

Bütünleştirilmiş Kodlar:

netstandard.dll, 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ın hedefini temsil eder. Yeni bir olay dinleyicisi oluşturulduğunda, bu uygulama etki alanındaki tüm olay kaynaklarına mantıksal olarak eklenir.

Note

Bu tür IDisposable arabirimini uygular. Türünü kullanmayı bitirdiğinizde, doğrudan veya dolaylı olarak atmalısınız. Türü doğrudan atabilmek için, bir Disposetry/ bloğunda catch yöntemini çağırın. Bunu dolaylı olarak atmak için using (C#'de) veya Using (Visual Basic'te) gibi 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 bu dinleyiciyi etkiler. yöntemiyle gönderilen komutların SendCommand diğer dinleyicileri etkileyen bir anlamsal işlem (çöp toplama veya boşaltma verileri gibi) yapması mümkündür, ancak bu kural yerine özel durumdur.

Her olay kaynağı, olayları gönderdiği olay dinleyicilerinin listesini tutar. Her olay kaynak dinleyicisi çifti ile 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, alt sınıfları EventListener verilerle yararlı bir şey yapmak için bu yöntemi geçersiz kılmalıdır.

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.

Important

Örneği EventListeneroluştururken oluşturucu OnEventSourceCreated öğesine OnEventWritten geri çağrı yapılır ve gerçekleşebilir. Bu geri aramalarda kullanılan örnek üyelerini başlatırken dikkatli olun.

Oluşturucular

Name	Description
EventListener()	sınıfının yeni bir örneğini EventListener oluşturur.

Yöntemler

Name	Description
DisableEvents(EventSource)	Belirtilen olay kaynağı için tüm olayları devre dışı bırakır.
Dispose()	Sınıfının geçerli örneği EventListener tarafından kullanılan kaynakları serbest bırakır.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Belirtilen ayrıntı düzeyine veya daha düşük, eşleşen olay anahtar sözcüğü bayrağına ve eşleşen bağımsız değişkenlere sahip 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)	Belirtilen ayrıntı düzeyi veya daha düşük olan 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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
OnEventSourceCreated(EventSource)	Olay dinleyicisi oluşturulduğunda ve dinleyiciye yeni bir olay kaynağı eklendiğinde var olan tüm olay kaynakları için çağrılır.
OnEventWritten(EventWrittenEventArgs)	Olay dinleyicisinin olayları etkinleştirdiği bir olay kaynağı tarafından bir olay yazıldığı her durumda çağrılır.
ToString()	Geçerli nesneyi temsil eden bir dize döndürür. (Devralındığı yer: Object)

Ekinlikler

Name	Description
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.