Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

TraceListener classe

 

Date de publication : novembre 2016

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

Espace de noms:   System.Diagnostics
Assembly:  System (dans System.dll)


[HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true)]
public abstract class TraceListener : MarshalByRefObject, IDisposable

NomDescription
System_CAPS_protmethodTraceListener()

Initialise une nouvelle instance de la classe TraceListener.

System_CAPS_protmethodTraceListener(String)

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

NomDescription
System_CAPS_pubpropertyAttributes

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

System_CAPS_pubpropertyFilter

Obtient et définit le filtre de trace pour l'écouteur de trace.

System_CAPS_pubpropertyIndentLevel

Obtient ou définit le niveau de retrait.

System_CAPS_pubpropertyIndentSize

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

System_CAPS_pubpropertyIsThreadSafe

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

System_CAPS_pubpropertyName

Obtient ou définit un nom pour ce TraceListener.

System_CAPS_protpropertyNeedIndent

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

System_CAPS_pubpropertyTraceOutputOptions

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

NomDescription
System_CAPS_pubmethodClose()

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.

System_CAPS_pubmethodCreateObjRef(Type)

Crée un objet qui contient toutes les informations requises pour générer un proxy permettant de communiquer avec un objet distant.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodDispose()

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

System_CAPS_protmethodDispose(Boolean)

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

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodFail(String)

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

System_CAPS_pubmethodFail(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.

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodFlush()

En cas de substitution dans une classe dérivée, vide la mémoire tampon de sortie.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetLifetimeService()

Récupère l’objet de service de durée de vie actuelle qui contrôle la stratégie de durée de vie de cette instance.(Hérité de MarshalByRefObject.)

System_CAPS_protmethodGetSupportedAttributes()

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

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

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

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Crée une copie superficielle d’actuel MarshalByRefObject objet.(Hérité de MarshalByRefObject.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodTraceData(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.

System_CAPS_pubmethodTraceData(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.

System_CAPS_pubmethodTraceEvent(TraceEventCache, String, TraceEventType, Int32)

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

System_CAPS_pubmethodTraceEvent(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.

System_CAPS_pubmethodTraceEvent(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.

System_CAPS_pubmethodTraceTransfer(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.

System_CAPS_pubmethodWrite(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.

System_CAPS_pubmethodWrite(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.

System_CAPS_pubmethodWrite(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.

System_CAPS_pubmethodWrite(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.

System_CAPS_protmethodWriteIndent()

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

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

System_CAPS_pubmethodWriteLine(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.

For examples of how to implement a T:System.Diagnostics.TraceListener, see the T:System.Diagnostics.DefaultTraceListener, T:System.Diagnostics.TextWriterTraceListener and the T:System.Diagnostics.EventLogTraceListener classes.

You must enable tracing or debugging to use a trace listener. The following syntax is compiler specific. If you use compilers other than C# or Visual Basic, refer to the documentation for your compiler.

  • To enable debugging in C#, add the /d:DEBUG flag to the compiler command line when you compile your code, or you can add #define DEBUG to the top of your file. In Visual Basic, add the /d:DEBUG=True flag to the compiler command line.

  • To enable tracing in C#, add the /d:TRACE flag to the compiler command line when you compile your code, or add #define TRACE to the top of your file. In Visual Basic, add the /d:TRACE=True flag to the compiler command line.

To add a trace listener, edit the configuration file that corresponds to the name of your application. Within this file, you can add a listener, set its type and set its parameter, remove a listener, or clear all the listeners previously set by the application. The configuration file should be formatted similar to the following example.

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

For more information on using configuration files for tracing, see <system.diagnostics> Element.

Remarques à l’attention des héritiers :

Inherit from this class to implement a custom listener for the T:System.Diagnostics.Debug and T:System.Diagnostics.Trace classes. At a minimum, you must implement the M:System.Diagnostics.TraceListener.Write(System.String) and M:System.Diagnostics.TraceListener.WriteLine(System.String) methods. Additionally, you can implement the M:System.Diagnostics.TraceListener.Fail(System.String), M:System.Diagnostics.TraceListener.Close and M:System.Diagnostics.TraceListener.Flush methods.

.NET Framework
Disponible depuis 1.1

This type is thread safe.

Retour au début
Afficher: