TraceListener Classe

Définition

Fournit la classe de base abstract pour les écouteurs qui surveillent la sortie de trace et de débogage.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public ref class TraceListener abstract : IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
public abstract class TraceListener : IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
type TraceListener = class
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TraceListener
Implements IDisposable
Héritage
TraceListener
Héritage
TraceListener
Dérivé
Implémente

Remarques

Pour obtenir des exemples d’implémentation d’un TraceListener, consultez les DefaultTraceListenerclasses , TextWriterTraceListener et EventLogTraceListener .

Vous devez activer le suivi ou le débogage pour utiliser un écouteur de trace. La syntaxe suivante est propre au compilateur. Si vous utilisez des compilateurs autres que C# ou Visual Basic, reportez-vous à la documentation de votre compilateur.

  • Pour activer le débogage en C#, ajoutez l’indicateur /d:DEBUG à la ligne de commande du compilateur lorsque vous compilez votre code, ou vous pouvez ajouter #define DEBUG en haut de votre fichier. En Visual Basic, ajoutez l’indicateur /d:DEBUG=True à la ligne de commande du compilateur.

  • Pour activer le suivi en C#, ajoutez l’indicateur /d:TRACE à la ligne de commande du compilateur lorsque vous compilez votre code, ou ajoutez #define TRACE en haut de votre fichier. En Visual Basic, ajoutez l’indicateur /d:TRACE=True à la ligne de commande du compilateur.

Pour ajouter un écouteur de trace, modifiez le fichier de configuration correspondant au nom de votre application. Dans ce fichier, vous pouvez ajouter un écouteur, définir son type et définir son paramètre, supprimer un écouteur ou effacer tous les écouteurs précédemment définis par l’application. Le fichier de configuration doit être mis en forme comme dans l’exemple suivant.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Pour plus d’informations sur l’utilisation des fichiers de configuration pour le suivi, consultez <system.diagnostics>.

Notes pour les responsables de l’implémentation

Héritez de cette classe pour implémenter un écouteur personnalisé pour les Debug classes et Trace . Au minimum, vous devez implémenter les Write(String) méthodes et .WriteLine(String) En outre, vous pouvez implémenter les Fail(String)méthodes et Flush()Close() .

Constructeurs

TraceListener()

Initialise une nouvelle instance de la classe TraceListener.

TraceListener(String)

Initialise une nouvelle instance de la classe TraceListener avec le nom spécifié pour l'écouteur.

Propriétés

Attributes

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

Filter

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

IndentLevel

Obtient ou définit le niveau de retrait.

IndentSize

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

IsThreadSafe

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

Name

Obtient ou définit un nom pour ce TraceListener.

NeedIndent

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

TraceOutputOptions

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

Méthodes

Close()

En cas de substitution dans une classe dérivée, ferme le flux de sortie pour qu'il ne reçoive plus la sortie de trace 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.

Dispose(Boolean)

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

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.

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()

En cas de substitution dans une classe dérivée, 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 tableau d'objets 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.

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.

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.

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.

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.

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.

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.

S’applique à

Cohérence de thread

Ce type est thread-safe.

Voir aussi