DiagnosticListener.Subscribe Méthode

Définition

Espace de noms:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Ces méthodes permettent d’ajouter un abonné et certaines d’entre elles fournissent des méthodes de filtre d’événement facultatives.

Surcharges

Subscribe(IObserver<KeyValuePair<String,Object>>)	Ajoute un abonné.
Subscribe(IObserver<KeyValuePair<String,Object>>, Func<String,Object,Object,Boolean>)	Ajoute un abonné et filtre éventuellement les événements en fonction de leur nom et de jusqu’à deux objets de contexte.
Subscribe(IObserver<KeyValuePair<String,Object>>, Predicate<String>)	Ajoute un abonné et filtre éventuellement les événements en fonction de leur nom.
Subscribe(IObserver<KeyValuePair<String,Object>>, Func<String,Object,Object,Boolean>, Action<Activity,Object>, Action<Activity,Object>)	Ajoute un abonné, filtre éventuellement les événements en fonction de leur nom et de jusqu’à deux objets de contexte, et spécifie les méthodes à appeler quand les fournisseurs importent ou exportent des activités depuis en dehors du processus.

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

Source:

DiagnosticListener.cs

Ajoute un abonné.

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

Paramètres

observer

IObserver<KeyValuePair<String,Object>>

Abonné.

Retours

IDisposable

Référence à une interface qui permet à l’écouteur d’arrêter de recevoir des notifications avant que la DiagnosticSource ait fini de les envoyer.

Implémente

Subscribe(IObserver<T>)

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

Source:

DiagnosticListener.cs

Ajoute un abonné et filtre éventuellement les événements en fonction de leur nom et de jusqu’à deux objets de contexte.

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

Paramètres

observer

IObserver<KeyValuePair<String,Object>>

Abonné.

isEnabled

Func<String,Object,Object,Boolean>

Délégué qui filtre les événements en fonction de leur nom et de jusqu’à deux objets de contexte (pouvant être null), ou null si un filtre d’événements n’est pas souhaitable.

Retours

IDisposable

Référence à une interface qui permet à l’écouteur d’arrêter de recevoir des notifications avant que la DiagnosticSource ait fini de les envoyer.

Remarques

Si isEnabled n’est pas null, cela indique que certains événements ne sont pas inintéressants peuvent être ignorés par souci d’efficacité.

Un site d’instrumentation particulier a la possibilité d’appeler une ou plusieurs IsEnabled surcharges dans lesquelles il transmet le nom de l’événement et jusqu’à deux autres objets (spécifiques au site d’instrumentation) en tant qu’arguments. Si l’un de ces IsEnabled appels est effectué, ce isEnabled prédicat est appelé avec des valeurs passées (si des surcharges plus courtes sont utilisées, null est passé pour les objets de contexte manquants).

Cela permet à n’importe quel site d’instrumentation particulier de transmettre jusqu’à deux informations à l’abonné pour effectuer un filtrage sophistiqué et efficace. Cela nécessite davantage de couplage entre le site d’instrumentation et le code de l’abonné.

Il est prévu qu’un site d’instrumentation particulier puisse appeler différentes surcharges de IsEnabled pour le même événement, en appelant IsEnabled(String)d’abord , qui appelle le filtre avec deux null objets de contexte. Si isEnabled retourne true, il appelle à nouveau avec des objets de contexte. Le isEnabled filtre doit être conçu dans cette optique.

Notez que le isEnabled prédicat est une optimisation facultative pour permettre au site d’instrumentation d’éviter de configurer la charge utile et d’appeler Write(String, Object) quand aucun abonné ne s’en soucie. En particulier, le site d’instrumentation a la possibilité d’ignorer le IsEnabled prédicat (sans l’appeler) et d’appeler Write(String, Object)simplement . Par conséquent, si l’abonné a besoin du filtrage, il doit le faire lui-même.

Si ce paramètre est null, aucun filtrage n’est effectué (toutes les surcharges de IsEnabled retour true).

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

Source:

DiagnosticListener.cs

Ajoute un abonné et filtre éventuellement les événements en fonction de leur nom.

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

Paramètres

observer

IObserver<KeyValuePair<String,Object>>

Abonné.

isEnabled

Predicate<String>

Délégué qui filtre les événements en fonction de leur nom (String). Le délégué doit retourner true si l’événement est activé.

Retours

IDisposable

Référence à une interface qui permet à l’écouteur d’arrêter de recevoir des notifications avant que la DiagnosticSource ait fini de les envoyer.

Remarques

Si isEnabled n’est pas null, certains événements ne sont pas inintéressants et peuvent être ignorés par souci d’efficacité. Le isEnabled prédicat est une optimisation facultative pour permettre au site d’instrumentation d’éviter de configurer la charge utile et d’appeler Write(String, Object) quand aucun abonné ne s’en soucie. En particulier, le site d’instrumentation a la possibilité d’ignorer le IsEnabled() prédicat (sans l’appeler) et d’appeler Write(String, Object)simplement . Par conséquent, si l’abonné a besoin du filtrage, il doit le faire lui-même.

Si isEnabled a la valeur null, aucun filtrage n’est effectué (toutes les surcharges de IsEnabled retour true).

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

Source:

DiagnosticSourceActivity.cs

Ajoute un abonné, filtre éventuellement les événements en fonction de leur nom et de jusqu’à deux objets de contexte, et spécifie les méthodes à appeler quand les fournisseurs importent ou exportent des activités depuis en dehors du processus.

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

Paramètres

observer

IObserver<KeyValuePair<String,Object>>

Abonné.

isEnabled

Func<String,Object,Object,Boolean>

Délégué qui filtre les événements en fonction de leur nom et de jusqu’à deux objets de contexte (pouvant être null), ou null si un filtre d’événements n’est pas souhaitable.

onActivityImport

Action<Activity,Object>

Délégué d’action qui reçoit l’activité affectée par un événement externe et un objet qui représente la requête entrante.

onActivityExport

Action<Activity,Object>

Délégué d’action qui reçoit l’activité affectée par un événement externe et un objet qui représente la requête sortante.

Retours

IDisposable

Référence à une interface qui permet à l’écouteur d’arrêter de recevoir des notifications avant que la DiagnosticSource ait fini de les envoyer.

Remarques

Si isEnabled n’est pas null, certains événements ne sont pas inintéressants peuvent être ignorés par souci d’efficacité.

Vous pouvez également fournir des méthodes « onActivityImport » et « onActivityExport » appelées lorsque des fournisseurs importent ou exportent des activités en dehors du processus (par exemple, à partir de requêtes HTTP). Ces méthodes sont appelées après l’importation ou l’exportation de l’activité et peuvent être utilisées pour modifier l’activité ou la demande sortante d’ajout de stratégie.