EventListener Classe

Définition

Espace de noms:

System.Diagnostics.Tracing

Assemblys:

netstandard.dll, System.Diagnostics.Tracing.dll

Source:

EventSource.cs

Fournit des méthodes pour activer et désactiver des événements à partir de sources d’événements.

public ref class EventListener abstract : IDisposable

public abstract class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Héritage

Object

EventListener

Implémente

IDisposable

Remarques

Un écouteur d’événements représente la cible de tous les événements générés par les implémentations de source d’événements (EventSource objet) dans le domaine d’application actuel. Lorsqu’un écouteur d’événements est créé, il est attaché logiquement à toutes les sources d’événements de ce domaine d’application.

Note

Ce type implémente l’interface IDisposable . Lorsque vous avez fini d’utiliser le type, vous devez le supprimer directement ou indirectement. Pour supprimer directement le type, appelez sa Dispose méthode dans un try/catch bloc. Pour la supprimer indirectement, utilisez une construction de langage telle que using (en C#) ou Using (en Visual Basic). Pour plus d’informations, consultez la section « Utilisation d’un objet implémentant IDisposable » dans la rubrique d’interface IDisposable .

Un écouteur d’événements peut activer ou désactiver par source d’événement actuelle en utilisant des niveaux d’événement (EventLevel) et des mots clés d’événement (EventKeywords) pour restreindre davantage l’ensemble d’événements à envoyer à l’écouteur. L’écouteur peut également envoyer des commandes arbitraires à une source d’événement actuelle spécifique à l’aide de la SendCommand méthode. Les significations des commandes sont spécifiques à l’implémentation de la source d’événement.

Plusieurs écouteurs d’événements peuvent être définis dans un domaine d’application unique. Chaque écouteur est logiquement indépendant des autres écouteurs afin que les événements activés ou désactivés par un écouteur affectent uniquement cet écouteur. Il est possible que les commandes envoyées avec la SendCommand méthode effectuent une opération sémantique (par exemple, un garbage collection ou des données de vidage) qui affecte les autres écouteurs, mais il s’agit de l’exception plutôt que de la règle.

Chaque source d’événement conserve une liste d’écouteurs d’événements auxquels il envoie des événements. Un ensemble de critères de filtrage est associé à chaque paire d’écouteurs source d’événement. Ces critères déterminent les événements reçus par l’écouteur pour la source d’événement actuelle. Les écouteurs reçoivent les événements sur leur OnEventWritten méthode. Par conséquent, les sous-classes de EventListener doivent remplacer cette méthode pour effectuer quelque chose d’utile avec les données.

Lorsqu’une source d’événement est créée, la OnEventSourceCreated méthode est appelée. Chaque écouteur d’événement actuel obtient exactement un OnEventSourceCreated appel pour chaque source d’événement actuelle qui peut l’envoyer. Lorsqu’un écouteur d’événements est créé, une série d’appels OnEventSourceCreated est effectuée pour avertir le nouvel écouteur de toutes les sources d’événements qui existaient avant la création de l’écouteur.

Important

Lors de l’instanciation d’un EventListener, les rappels OnEventSourceCreated à et OnEventWritten peuvent se produire avant la fin du constructeur. Prenez soin lorsque vous initialisez les membres d’instance utilisés dans ces rappels.

Constructeurs

Nom	Description
EventListener()	Crée une instance de la EventListener classe.

Méthodes

Nom	Description
DisableEvents(EventSource)	Désactive tous les événements de la source d’événement spécifiée.
Dispose()	Libère les ressources utilisées par l’instance actuelle de la EventListener classe.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Active les événements pour la source d’événement spécifiée qui a le niveau de détail spécifié ou inférieur, l’indicateur de mot clé d’événement correspondant et les arguments correspondants.
EnableEvents(EventSource, EventLevel, EventKeywords)	Active les événements pour la source d’événements spécifiée qui a le niveau de détail ou les indicateurs de mot clé correspondants spécifiés.
EnableEvents(EventSource, EventLevel)	Active les événements pour la source d’événement spécifiée qui a le niveau de détail spécifié ou inférieur.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
EventSourceIndex(EventSource)	Obtient un petit nombre non négatif qui représente la source d’événement spécifiée.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnEventSourceCreated(EventSource)	Appelé pour toutes les sources d’événements existantes lorsque l’écouteur d’événement est créé et lorsqu’une nouvelle source d’événement est attachée à l’écouteur.
OnEventWritten(EventWrittenEventArgs)	Appelé chaque fois qu’un événement a été écrit par une source d’événement pour laquelle l’écouteur d’événements a activé les événements.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Événements

Nom	Description
EventSourceCreated	Se produit lorsqu’une source d’événement (EventSource objet) est attachée au répartiteur.
EventWritten	Se produit lorsqu’un événement a été écrit par une source d’événement (EventSource objet) pour laquelle l’écouteur d’événements a activé les événements.