EventListener Classe

Définition

Espace de noms:

System.Diagnostics.Tracing

Assembly:

System.Diagnostics.Tracing.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

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 ref class EventListener : IDisposable

public abstract class EventListener : IDisposable

public class EventListener : IDisposable

type EventListener = class
    interface IDisposable

Public MustInherit Class EventListener
Implements IDisposable

Public 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.

Notes

Ce type implémente l'interface IDisposable. Lorsque vous avez terminé d’utiliser le type, vous devez le supprimer 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 par source d’événements en cours à l’aide de niveaux d’événements (EventLevel) et de 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 un vidage de 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 il envoie des événements. Un ensemble de critères de filtrage est associé à chaque paire d’écouteurs source d’événements. 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 nouvelle 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 sont effectués 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 vers OnEventSourceCreated et OnEventWritten peuvent se produire avant la fin du constructeur. Prenez soin lorsque vous initialisez les membres de l’instance 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.