Exporter (0) Imprimer
Développer tout

TraceListener, classe

Mise à jour : novembre 2007

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
/** @attribute HostProtectionAttribute(SecurityAction.LinkDemand, Synchronization = true) */
public abstract class TraceListener extends MarshalByRefObject implements IDisposable
public abstract class TraceListener extends MarshalByRefObject implements IDisposable

Remarque :

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.

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.

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.

Ce type est thread-safe.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile pour Smartphone, Windows Mobile pour Pocket PC, Xbox 360

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

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Pris en charge dans : 3.5, 2.0, 1.0

XNA Framework

Pris en charge dans : 2.0, 1.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft