Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout

Trace, classe

Fournit un jeu de méthodes et de propriétés qui vous aident à suivre l'exécution de votre code. Cette classe ne peut pas être héritée.

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

public sealed class Trace
public final class Trace
public final class Trace

Vous pouvez utiliser les propriétés et les méthodes dans la classe Trace pour instrumenter les versions release. L'instrumentation vous permet de surveiller l'état de santé de votre application fonctionnant dans des conditions de paramétrage réelles. Le traçage vous aide à isoler les problèmes et à les résoudre sans affecter un système en cours d'exécution.

RemarqueRemarque

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 fournir une fonction équivalente en C++, vous devez englober les appels aux méthodes de cette classe dans un bloc #ifdef TRACE... #endif. Cette syntaxe est spécifique au compilateur. Si vous utilisez un compilateur autre que ceux qui sont spécifiés ci-dessus, vous devez vous référer à la documentation du compilateur pour activer la compilation conditionnelle en raison des attributs de compilation conditionnelle placés sur les méthodes de la classe Trace.

Dans les projets Visual Studio 2005, Trace est activé par défaut. Par conséquent, du code est généré pour toutes les méthodes Trace dans les versions release et debug. Ceci permet à un utilisateur final d'activer le traçage pour faciliter l'identification du problème sans que le programme ait à être recompilé. Par opposition, Debug est désactivé par défaut dans les versions release, donc aucun code exécutable n'est généré pour les méthodes Debug. Pour désactiver Trace, consultez la documentation Visual Studio 2005.

Cette classe fournit des méthodes d'affichage d'une boîte de dialogue Assert et permet d'envoyer une assertion qui sera toujours Fail. Cette classe fournit des méthodes d'écriture avec les variations suivantes : Write, WriteLine, WriteIf et WriteLineIf.

Les classes BooleanSwitch et TraceSwitch fournissent des moyens de contrôler de manière dynamique la sortie du traçage. Vous pouvez modifier les valeurs de ces commutateurs sans recompiler votre application. Pour plus d'informations sur l'utilisation du fichier de configuration pour définir un commutateur, consultez la classe Switch et la rubrique Comment : configurer les commutateurs de trace.

Vous pouvez personnaliser la cible de la sortie du traçage en ajoutant des instances de TraceListener à la collection Listeners, ou en en supprimant. Par défaut, la sortie de traçage est émise à l'aide de la classe DefaultTraceListener.

La classe Trace fournit les propriétés pour obtenir ou définir le niveau de Indent et IndentSize et pour indiquer s'il faut AutoFlush après chaque écriture.

Pour définir les paramètres AutoFlush et IndentSize pour Trace, vous pouvez modifier le fichier de configuration correspondant au nom de votre application. Le fichier de configuration doit être mis en forme comme l'exemple suivant :

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

Remarque sur la plate-forme Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows CE : Le .NET Compact Framework ne prend pas en charge les fonctionnalités de traçage qui utilisent un fichier de configuration.

L'exemple suivant utilise Trace pour indiquer le début et la fin de l'exécution d'un programme. L'exemple utilise également Indent et Unindent pour distinguer la sortie du traçage.

static int Main(string[] args)
{
   Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
   Trace.AutoFlush = true;
   Trace.Indent();
   Trace.WriteLine("Entering Main");
   Console.WriteLine("Hello World.");
   Trace.WriteLine("Exiting Main"); 
   Trace.Unindent();
   return 0;
}


System.Object
  System.Diagnostics.Trace

Ce type est thread-safe.

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

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

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

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:
© 2015 Microsoft