EventListener Classe

Définition

Espace de noms:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Source:

EventSource.cs

Fournit des méthodes permettant d’activer et de désactiver des événements à partir des 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 pour 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 dans ce domaine d’application.

Notes

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

Un écouteur d’événements peut activer ou désactiver chaque source d’événement en cours 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 active 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, de sorte 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 (telle qu’un garbage collection ou un vidage des données) qui affecte les autres écouteurs, mais il s’agit de l’exception plutôt que de la règle.

Chaque source d’événements conserve une liste d’écouteurs d’événements auxquels elle envoie des événements. Un ensemble de critères de filtrage est associé à chaque paire source-écouteur d’événement. Ces critères déterminent les événements que l’écouteur recevra 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 faire quelque chose d’utile avec les données.

Lorsqu’une nouvelle source d’événements est créée, la OnEventSourceCreated méthode est appelée. Chaque écouteur d’événements actuel reçoit exactement un OnEventSourceCreated appel pour chaque source d’événement actuel qui peut lui envoyer des messages de journal. Lorsqu’un écouteur d’événements est créé, une série d’appels OnEventSourceCreated sont effectués pour informer 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, le rappel à OnEventSourceCreated et OnEventWritten peut se produire avant la fin du constructeur. Veillez à initialiser instance membres utilisés dans ces rappels.

Constructeurs

EventListener()

Crée une instance de la classe EventListener.

Méthodes

DisableEvents(EventSource)	Désactive tous les événements de la source d'événements spécifiée.
Dispose()	Libère les ressources utilisées par l'instance actuelle de la classe EventListener.
EnableEvents(EventSource, EventLevel)	Active les événements pour la source d’événements spécifiée qui a le niveau de détail spécifié ou un niveau inférieur.
EnableEvents(EventSource, EventLevel, EventKeywords)	Active les événements pour la source d'événements spécifiée qui a le niveau de commentaires spécifié ou un niveau inférieur, et les indicateurs de mot clé de correspondance.
EnableEvents(EventSource, EventLevel, EventKeywords, IDictionary<String,String>)	Active les événements pour la source d’événements spécifiée qui a le niveau de commentaires spécifié ou un niveau inférieur, les indicateurs de mot clé de correspondance et les arguments de correspondance.
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énements spécifiée.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnEventSourceCreated(EventSource)	Appelée pour toutes les sources d'événements existantes lorsque l'écouteur d'événements est créé et lorsqu'une nouvelle source d'événements est attachée à l'écouteur.
OnEventWritten(EventWrittenEventArgs)	Appelée lorsqu'un événement a été écrit par une source d'événements pour laquelle l'écouteur d'événements a des événements activés.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

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