Partager via


EventProviderTraceListener Classe

Définition

Écouteur de TraceSource qui écrit des événements dans le sous-système ETW.

public ref class EventProviderTraceListener : System::Diagnostics::TraceListener
public class EventProviderTraceListener : System.Diagnostics.TraceListener
type EventProviderTraceListener = class
    inherit TraceListener
Public Class EventProviderTraceListener
Inherits TraceListener
Héritage
EventProviderTraceListener

Exemples

private static Guid providerId = new Guid("{B3F0C8FC-E8A8-4868-8901-1465E8A2F41B}");  

    EventProviderTraceListener listener = new EventProviderTraceListener(providerId.ToString(), "Test Listener", "::");  

    // You should use the All default level and control the level using the  
    // ETW session; otherwise, you may not log all the events requested by the  
    // session.  
    TraceSource source = new TraceSource("MyProvider", SourceLevels.All);  

    source.Listeners.Add(listener);  

    source.TraceData(TraceEventType.Warning | TraceEventType.Start, 2, new object[] { "abc", "def", true, 123 });  

    source.TraceEvent(TraceEventType.Warning, 12, "Provider guid: {0}", new object[] { providerId });  

    source.TraceInformation("string {0}, bool {1}, int {2}, ushort {3}", new object[] { "abc", false, 123, (UInt32)5 });  

Remarques

Toutes les données d’événement (trace ou débogage) de l’événement source sont écrites dans le sous-système ETW sous la forme d’une chaîne. Les éléments de données sont délimités à l’aide d’une virgule. Pour spécifier un autre délimiteur, utilisez la Delimiter propriété .

L’ajout de l’écouteur à System.Diagnostics.TraceSource inscrit le fournisseur auprès du sous-système ETW. Vous devez créer une session de suivi ETW à l’aide du programme exécutable Logman.exe (ou quelque chose de similaire) pour écrire les événements dans un fichier journal.

Vous n’avez pas besoin d’un manifeste pour utiliser les événements de l’écouteur, car les données d’événement sont une chaîne unique.

Lorsque vous appelez les System.Diagnostics.TraceSource méthodes pour écrire des événements, vous passez une valeur d’énumération System.Diagnostics.TraceEventType . L’énumération contient des valeurs de niveau et de mot clé. Lorsque vous activez un fournisseur d’écouteurs de suivi à partir d’une session ETW, la valeur de niveau que vous spécifiez peut être la valeur associée à l’une des valeurs d’énumération suivantes System.Diagnostics.TraceEventType :

  • Critique (la valeur est 1)

  • Erreur (la valeur est 2)

  • Informations (la valeur est 8)

  • Détaillé (la valeur est 16)

  • Avertissement (la valeur est 4)

La valeur du mot clé que vous spécifiez pour la session peut être la valeur associée à l’une des valeurs d’énumération suivantes System.Diagnostics.TraceEventType :

  • Reprendre (la valeur est 2 048)

  • Démarrer (la valeur est 256)

  • Arrêter (la valeur est 512)

  • Suspendre (la valeur est 1 024)

  • Transfert (valeur 4 096)

Constructeurs

EventProviderTraceListener(String)

Initialise une nouvelle instance de la classe EventProviderTraceListener à l'aide de l'identificateur du fournisseur spécifié.

EventProviderTraceListener(String, String)

Initialise une nouvelle instance de la classe EventProviderTraceListener en utilisant l'identificateur du fournisseur spécifié et le nom de l'écouteur.

EventProviderTraceListener(String, String, String)

Initialise une nouvelle instance de la classe EventProviderTraceListener en utilisant l'identificateur du fournisseur spécifié, le nom de l'écouteur et le séparateur.

Propriétés

Attributes

Obtient les attributs d'écouteur de trace personnalisés définis dans le fichier de configuration de l'application.

(Hérité de TraceListener)
Delimiter

Obtient ou définit le séparateur utilisé pour délimiter les données de l’événement écrites dans le sous-système ETW.

Filter

Obtient ou définit le filtre de trace pour l’écouteur de la trace.

(Hérité de TraceListener)
IndentLevel

Obtient ou définit le niveau de retrait.

(Hérité de TraceListener)
IndentSize

Obtient ou définit le nombre d'espaces dans un retrait.

(Hérité de TraceListener)
IsThreadSafe

Obtient une valeur qui indique si l'écouteur de trace est thread-safe.

Name

Obtient ou définit un nom pour ce TraceListener.

(Hérité de TraceListener)
NeedIndent

Obtient ou définit une valeur indiquant si la sortie doit être mise en retrait.

(Hérité de TraceListener)
TraceOutputOptions

Obtient ou définit les options de sortie de trace.

(Hérité de TraceListener)

Méthodes

Close()

Ferme le flux de sortie pour qu’il ne reçoive plus la sortie de traçage ou de débogage.

CreateObjRef(Type)

Crée un objet contenant toutes les informations appropriées requises pour générer un proxy permettant de communiquer avec un objet distant.

(Hérité de MarshalByRefObject)
Dispose()

Libère toutes les ressources utilisées par TraceListener.

(Hérité de TraceListener)
Dispose(Boolean)

Libère les ressources non managées utilisées par TraceListener et libère éventuellement les ressources managées.

(Hérité de TraceListener)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
Fail(String)

Émet un message d'erreur à l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.

(Hérité de TraceListener)
Fail(String, String)

Émet un message d'erreur, ainsi qu'un message d'erreur détaillé, à l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.

Flush()

Vide la mémoire tampon de sortie.

GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetLifetimeService()
Obsolète.

Récupère l'objet de service de durée de vie en cours qui contrôle la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
GetSupportedAttributes()

Obtient les attributs personnalisés pris en charge par l'écouteur de trace.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InitializeLifetimeService()
Obsolète.

Obtient un objet de service de durée de vie pour contrôler la stratégie de durée de vie de cette instance.

(Hérité de MarshalByRefObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MemberwiseClone(Boolean)

Crée une copie superficielle de l'objet MarshalByRefObject actuel.

(Hérité de MarshalByRefObject)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Écrit les informations sur la trace, un objet de données et les informations sur les événements dans la sortie spécifique de l'écouteur.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Écrit les informations sur la trace, un objet de données et les informations sur les événements dans la sortie spécifique de l'écouteur.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Écrit les informations sur la trace et les événements dans la sortie spécifique de l'écouteur.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Écrit les informations sur la trace, un message et les informations sur les événements dans la sortie spécifique de l'écouteur.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Écrit les informations sur la trace, un tableau d'objets mis en forme et les informations sur les événements dans la sortie spécifique de l'écouteur.

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Écrit les informations sur la trace, un message, une identité d'activité connexe et les informations sur les événements dans la sortie spécifique de l'écouteur.

Write(Object)

Écrit la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.

(Hérité de TraceListener)
Write(Object, String)

Écrit un nom de catégorie ou la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.

(Hérité de TraceListener)
Write(String)

En cas de substitution dans une classe dérivée, écrit le message spécifié dans l'écouteur que vous créez dans la classe dérivée.

Write(String, String)

Écrit un nom de catégorie et un message dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.

(Hérité de TraceListener)
WriteIndent()

Écrit la mise en retrait dans l'écouteur que vous créez lors de l'implémentation de cette classe et rétablit la valeur false à la propriété NeedIndent.

(Hérité de TraceListener)
WriteLine(Object)

Écrit la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivie d'une marque de fin de ligne.

(Hérité de TraceListener)
WriteLine(Object, String)

Écrit un nom de catégorie ou la valeur de la méthode ToString() de l'objet dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivis d'une marque de fin de ligne.

(Hérité de TraceListener)
WriteLine(String)

En cas de substitution dans une classe dérivée, écrit un message dans l'écouteur que vous créez dans la classe dérivée, suivi d'une marque de fin de ligne.

WriteLine(String, String)

Écrit un nom de catégorie ou un message dans l'écouteur que vous créez lors de l'implémentation de la classe TraceListener, suivis d'une marque de fin de ligne.

(Hérité de TraceListener)

S’applique à

Voir aussi