Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

TraceListener, classe

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

Le type TraceListener expose les membres suivants.

  NomDescription
Méthode protégéePris en charge par XNA FrameworkTraceListener()Initialise une nouvelle instance de la classe TraceListener.
Méthode protégéePris en charge par XNA FrameworkTraceListener(String)Initialise une nouvelle instance de la classe TraceListener avec le nom spécifié pour l'écouteur.
Début

  NomDescription
Propriété publiqueAttributesObtient les attributs d'écouteur de la trace personnalisé définis dans le fichier de configuration de l'application.
Propriété publiqueFilterObtient et définit le filtre de trace pour l'écouteur de la trace.
Propriété publiquePris en charge par XNA FrameworkIndentLevelObtient ou définit le niveau de retrait.
Propriété publiquePris en charge par XNA FrameworkIndentSizeObtient ou définit le nombre d'espaces dans un retrait.
Propriété publiqueIsThreadSafeObtient une valeur qui indique si l'écouteur de la trace est thread-safe.
Propriété publiquePris en charge par XNA FrameworkNameObtient ou définit un nom pour ce TraceListener.
Propriété protégéePris en charge par XNA FrameworkNeedIndentObtient ou définit une valeur indiquant si le résultat doit être mis en retrait.
Propriété publiqueTraceOutputOptionsObtient ou définit les options de sortie de trace.
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkCloseEn 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.
Méthode publiqueCreateObjRefCré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.)
Méthode publiquePris en charge par XNA FrameworkDispose()Libère toutes les ressources utilisées par TraceListener.
Méthode protégéePris en charge par XNA FrameworkDispose(Boolean)Libère les ressources non managées utilisées par TraceListener et libère éventuellement les ressources managées.
Méthode publiquePris en charge par XNA FrameworkEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkFail(String)Envoie un message d'erreur à l'écouteur que vous créez lors de l'implémentation de la classe TraceListener.
Méthode publiquePris en charge par XNA FrameworkFail(String, String)Envoie 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.
Méthode protégéePris en charge par XNA FrameworkFinalize 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.)
Méthode publiquePris en charge par XNA FrameworkFlushEn cas de substitution dans une classe dérivée, vide la mémoire tampon de sortie.
Méthode publiquePris en charge par XNA FrameworkGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiqueGetLifetimeServiceRé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.)
Méthode protégéeGetSupportedAttributesObtient les attributs personnalisés pris en charge par l'écouteur de la trace.
Méthode publiquePris en charge par XNA FrameworkGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueInitializeLifetimeServiceObtient 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.)
Méthode protégéePris en charge par XNA FrameworkMemberwiseClone()Crée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode protégéeMemberwiseClone(Boolean)Crée une copie superficielle de l'objet MarshalByRefObject actuel. (Hérité de MarshalByRefObject.)
Méthode publiquePris en charge par XNA FrameworkToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiqueTraceData(TraceEventCache, String, TraceEventType, Int32, Object)Écrit des informations de traçage, un objet de données et des informations d'événement, dans la sortie spécifique de l'écouteur.
Méthode publiqueTraceData(TraceEventCache, String, TraceEventType, Int32, Object[])Écrit des informations de traçage, un tableau d'objets de données et des informations d'événement, dans la sortie spécifique de l'écouteur.
Méthode publiqueTraceEvent(TraceEventCache, String, TraceEventType, Int32)Écrit des informations de traçage et d'événement dans la sortie spécifique de l'écouteur.
Méthode publiqueTraceEvent(TraceEventCache, String, TraceEventType, Int32, String)Écrit des informations de traçage, un message et des informations d'événement dans la sortie spécifique de l'écouteur.
Méthode publiqueTraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])Écrit des informations de traçage, un tableau d'objets mis en forme et des informations d'événement dans la sortie spécifique de l'écouteur.
Méthode publiqueTraceTransferÉcrit des informations de traçage, un message, une identité d'activité connexe et des informations d'événement dans la sortie spécifique de l'écouteur.
Méthode publiquePris en charge par XNA FrameworkWrite(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.
Méthode publiquePris en charge par XNA FrameworkWrite(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.
Méthode publiquePris en charge par XNA FrameworkWrite(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.
Méthode publiquePris en charge par XNA FrameworkWrite(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.
Méthode protégéePris en charge par XNA FrameworkWriteIndentÉ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.
Méthode publiquePris en charge par XNA FrameworkWriteLine(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'un terminateur de ligne.
Méthode publiquePris en charge par XNA FrameworkWriteLine(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'un terminateur de ligne.
Méthode publiquePris en charge par XNA FrameworkWriteLine(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'un terminateur de ligne.
Méthode publiquePris en charge par XNA FrameworkWriteLine(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'un terminateur de ligne.
Début

Pour obtenir des exemples d'implémentation d'un TraceListener, consultez les classes DefaultTraceListener, TextWriterTraceListener et EventLogTraceListener.

Vous devez activer le traçage ou le débogage pour utiliser l'écouteur de la trace. La syntaxe suivante est spécifique au compilateur. Si vous utilisez des compilateurs autres que C# ou Visual Basic, consultez la documentation de votre compilateur.

  • Pour activer le débogage en C#, ajoutez l'indicateur /d:DEBUG à la ligne de commande du compilateur lors de la compilation du code, ou ajoutez #define DEBUG au début du fichier. En Visual Basic, ajoutez l'indicateur /d:DEBUG=True à la ligne de commande du compilateur.

  • Pour activer le traçage en C#, ajoutez l'indicateur /d:TRACE à la ligne de commande du compilateur lors de la compilation du code ou ajoutez #define TRACE au début du fichier. En Visual Basic, ajoutez l'indicateur /d:TRACE=True à la ligne de commande du compilateur.

Pour ajouter un écouteur de la 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 ses paramètres, supprimer un écouteur ou réinitialiser tous les écouteurs définis précédemment par l'application. Le fichier de configuration doit être mis en forme conformément à l'exemple ci-dessous.

<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 de fichiers de configuration pour le traçage, consultez <system.diagnostics>, élément.

RemarqueRemarque

L'attribut HostProtectionAttribute appliqué à ce type ou membre a la valeur de propriété Resources suivante : Synchronization. HostProtectionAttribute n'affecte pas les applications bureautiques (qui sont généralement démarrées en double-cliquant sur une icône, en tapant une commande ou en entrant une URL dans un navigateur). Pour plus d'informations, consultez la classe HostProtectionAttribute ou Attributs de programmation et de protection des hôtes SQL Server.

Remarques à l'attention des héritiers

Héritez de cette classe pour implémenter un écouteur personnalisé pour les classes Debug et Trace. Vous devez au moins implémenter les méthodes Write et WriteLine. Par ailleurs, vous pouvez implémenter les méthodes Fail, Close et Flush.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ce type est thread-safe.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft