EventProviderTraceListener Classe

Référence

Définition

Espace de noms:: System.Diagnostics.Eventing

Assembly:: System.Core.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

É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: Object

MarshalByRefObject

TraceListener
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

TraceListener

Partager via