DiagnosticListener.Subscribe Yöntem

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.DiagnosticSource.dll

Bu yöntemler abone eklemeye olanak sağlar ve bazıları isteğe bağlı olay filtreleme yöntemleri sağlar.

Aşırı Yüklemeler

Subscribe(IObserver<KeyValuePair<String,Object>>)	Abone ekler.
Subscribe(IObserver<KeyValuePair<String,Object>>, Func<String,Object,Object,Boolean>)	Abone ekler ve isteğe bağlı olarak olayları adlarına ve en çok iki bağlam nesnesine göre filtreler.
Subscribe(IObserver<KeyValuePair<String,Object>>, Predicate<String>)	Abone ekler ve isteğe bağlı olarak olayları adlarına göre filtreler.
Subscribe(IObserver<KeyValuePair<String,Object>>, Func<String,Object,Object,Boolean>, Action<Activity,Object>, Action<Activity,Object>)	Abone ekler, isteğe bağlı olarak olayları adlarına ve en çok iki bağlam nesnesine göre filtreler ve sağlayıcılar işlem dışından etkinleştirmeleri içeri veya dışarı aktardığında çağrılacak yöntemleri belirtir.

Subscribe(IObserver<KeyValuePair<String,Object>>)

Kaynak:

DiagnosticListener.cs

Abone ekler.

public:
 virtual IDisposable ^ Subscribe(IObserver<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>> ^ observer);

public virtual IDisposable Subscribe (IObserver<System.Collections.Generic.KeyValuePair<string,object?>> observer);

abstract member Subscribe : IObserver<System.Collections.Generic.KeyValuePair<string, obj>> -> IDisposable
override this.Subscribe : IObserver<System.Collections.Generic.KeyValuePair<string, obj>> -> IDisposable

Public Overridable Function Subscribe (observer As IObserver(Of KeyValuePair(Of String, Object))) As IDisposable

Parametreler

observer

IObserver<KeyValuePair<String,Object>>

Abone.

Döndürülenler

IDisposable

Dinleyicinin bildirimleri göndermeyi bitirmeden önce bildirimleri almayı durdurmasını DiagnosticSource sağlayan bir arabirim başvurusu.

Uygulamalar

Subscribe(IObserver<T>)

Subscribe(IObserver<KeyValuePair<String,Object>>, Func<String,Object,Object,Boolean>)

Kaynak:

DiagnosticListener.cs

Abone ekler ve isteğe bağlı olarak olayları adlarına ve en çok iki bağlam nesnesine göre filtreler.

public:
 virtual IDisposable ^ Subscribe(IObserver<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>> ^ observer, Func<System::String ^, System::Object ^, System::Object ^, bool> ^ isEnabled);

public virtual IDisposable Subscribe (IObserver<System.Collections.Generic.KeyValuePair<string,object?>> observer, Func<string,object?,object?,bool>? isEnabled);

abstract member Subscribe : IObserver<System.Collections.Generic.KeyValuePair<string, obj>> * Func<string, obj, obj, bool> -> IDisposable
override this.Subscribe : IObserver<System.Collections.Generic.KeyValuePair<string, obj>> * Func<string, obj, obj, bool> -> IDisposable

Public Overridable Function Subscribe (observer As IObserver(Of KeyValuePair(Of String, Object)), isEnabled As Func(Of String, Object, Object, Boolean)) As IDisposable

Parametreler

observer

IObserver<KeyValuePair<String,Object>>

Abone.

isEnabled

Func<String,Object,Object,Boolean>

Olayları adlarına ve en çok iki bağlam nesnesine (olabilir null) göre veya null bir olay filtresi istenmiyorsa filtreleyen bir temsilci.

Döndürülenler

IDisposable

Dinleyicinin bildirimleri göndermeyi bitirmeden önce bildirimleri almayı durdurmasını DiagnosticSource sağlayan bir arabirim başvurusu.

Açıklamalar

nulldeğilseisEnabled, verimlilik için bazı olayların ilgi çekici olmadığını gösterir.

Belirli bir izleme sitesi, olayın adını ve en fazla iki diğer (izleme sitesine özgü) nesneyi bağımsız değişken olarak geçirdiği bir veya daha fazla IsEnabled aşırı yüklemeyi çağırma seçeneğine sahiptir. Bu IsEnabled çağrılardan herhangi biri yapılırsa, bu isEnabled koşul geçirilen değerlerle çağrılır (daha kısa aşırı yüklemeler kullanılırsa, null eksik bağlam nesneleri için geçirilir).

Bu, herhangi bir izleme sitesine karmaşık ve verimli filtreleme yapmak için aboneye iki parçaya kadar bilgi geçirme olanağı sağlar. Bunun için izleme sitesi ile abone kodu arasında daha fazla bağlantı gerekir.

Belirli bir izleme sitesinin, filtreyi iki null bağlam nesnesiyle çağıran ilk çağrı IsEnabled(String)olarak aynı olay için farklı aşırı yüklemelerini IsEnabled çağırabileceği beklenir. döndürürse isEnabledtrue, bağlam nesneleriyle yeniden çağırır. Filtre isEnabled , bunu göz önünde bulundurarak tasarlanmalıdır.

Koşulun isEnabled , izleme sitesinin yükü ayarlamasını ve abonenin ilgilenmediğini çağırmasını Write(String, Object) önlemek için isteğe bağlı bir iyileştirme olduğunu unutmayın. Özellikle, izleme sitesi koşulu yoksayma IsEnabled (çağırmama) ve yalnızca çağırma Write(String, Object)seçeneğine sahiptir. Bu nedenle, abone filtrelemeyi gerektiriyorsa, bunu kendi yapması gerekir.

Bu parametre isenull, filtreleme yapılmaz (döndürülen truetüm aşırı yüklemeler IsEnabled ).

Subscribe(IObserver<KeyValuePair<String,Object>>, Predicate<String>)

Kaynak:

DiagnosticListener.cs

Abone ekler ve isteğe bağlı olarak olayları adlarına göre filtreler.

public:
 virtual IDisposable ^ Subscribe(IObserver<System::Collections::Generic::KeyValuePair<System::String ^, System::Object ^>> ^ observer, Predicate<System::String ^> ^ isEnabled);

public virtual IDisposable Subscribe (IObserver<System.Collections.Generic.KeyValuePair<string,object?>> observer, Predicate<string>? isEnabled);

abstract member Subscribe : IObserver<System.Collections.Generic.KeyValuePair<string, obj>> * Predicate<string> -> IDisposable
override this.Subscribe : IObserver<System.Collections.Generic.KeyValuePair<string, obj>> * Predicate<string> -> IDisposable

Public Overridable Function Subscribe (observer As IObserver(Of KeyValuePair(Of String, Object)), isEnabled As Predicate(Of String)) As IDisposable

Parametreler

observer

IObserver<KeyValuePair<String,Object>>

Abone.

isEnabled

Predicate<String>

Olayları adlarına () göre filtreleyen birString temsilci. Olay etkinse temsilci döndürülmelidir true .

Döndürülenler

IDisposable

Dinleyicinin bildirimleri göndermeyi bitirmeden önce bildirimleri almayı durdurmasını DiagnosticSource sağlayan bir arabirim başvurusu.

Açıklamalar

nulldeğilseisEnabled, bazı olaylar ilgi çekici değildir ve verimlilik için atlanabilir. Koşul isEnabled , izleme sitesinin yükü ayarlamasını ve abonenin umursamadığı durumlarda çağırmasını Write(String, Object) önlemek için isteğe bağlı bir iyileştirmedir. Özellikle izleme sitesinin koşulunu IsEnabled() yoksayma (çağırmama) ve yalnızca çağırma Write(String, Object)seçeneği vardır. Bu nedenle abone filtrelemeyi gerektiriyorsa, bunu kendi yapması gerekir.

ise isEnablednull, filtreleme yapılmaz (döndürülen truetüm aşırı yüklemeler IsEnabled ).

Subscribe(IObserver<KeyValuePair<String,Object>>, Func<String,Object,Object,Boolean>, Action<Activity,Object>, Action<Activity,Object>)

Kaynak:

DiagnosticSourceActivity.cs

Abone ekler, isteğe bağlı olarak olayları adlarına ve en çok iki bağlam nesnesine göre filtreler ve sağlayıcılar işlem dışından etkinleştirmeleri içeri veya dışarı aktardığında çağrılacak yöntemleri belirtir.

public virtual IDisposable Subscribe (IObserver<System.Collections.Generic.KeyValuePair<string,object?>> observer, Func<string,object?,object?,bool>? isEnabled, Action<System.Diagnostics.Activity,object?>? onActivityImport = default, Action<System.Diagnostics.Activity,object?>? onActivityExport = default);

abstract member Subscribe : IObserver<System.Collections.Generic.KeyValuePair<string, obj>> * Func<string, obj, obj, bool> * Action<System.Diagnostics.Activity, obj> * Action<System.Diagnostics.Activity, obj> -> IDisposable
override this.Subscribe : IObserver<System.Collections.Generic.KeyValuePair<string, obj>> * Func<string, obj, obj, bool> * Action<System.Diagnostics.Activity, obj> * Action<System.Diagnostics.Activity, obj> -> IDisposable

Public Overridable Function Subscribe (observer As IObserver(Of KeyValuePair(Of String, Object)), isEnabled As Func(Of String, Object, Object, Boolean), Optional onActivityImport As Action(Of Activity, Object) = Nothing, Optional onActivityExport As Action(Of Activity, Object) = Nothing) As IDisposable

Parametreler

observer

IObserver<KeyValuePair<String,Object>>

Abone.

isEnabled

Func<String,Object,Object,Boolean>

Olayları adlarına ve en çok iki bağlam nesnesine (olabilir null) göre veya null bir olay filtresi istenmiyorsa filtreleyen bir temsilci.

onActivityImport

Action<Activity,Object>

Dış olaydan etkilenen etkinliği ve gelen isteği temsil eden bir nesneyi alan eylem temsilcisi.

onActivityExport

Action<Activity,Object>

Dış olaydan etkilenen etkinliği alan eylem temsilcisi ve giden isteği temsil eden bir nesne.

Döndürülenler

IDisposable

Dinleyicinin bildirimleri göndermeyi bitirmeden önce bildirimleri almayı durdurmasını DiagnosticSource sağlayan bir arabirim başvurusu.

Açıklamalar

isEnabled null değilse, verimlilik için bazı olaylar ilgi çekici değildir atlanabilir.

İşlem dışından (örneğin, HTTP isteklerinden) etkinlikleri içeri veya dışarı aktaran sağlayıcılar tarafından çağrılan 'onActivityImport' ve 'onActivityExport' yöntemlerini de sağlayabilirsiniz. Bu yöntemler, etkinliği içeri veya dışarı aktardıktan sonra çağrılır ve ilke eklemek için etkinliği veya giden isteği değiştirmek için kullanılabilir.