Exporter (0) Imprimer
Développer tout

Debug, classe

Fournit un jeu de méthodes et de propriétés qui aident à déboguer votre code. Cette classe ne peut pas être héritée.

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

public sealed class Debug
public final class Debug
public final class Debug

Si vous utilisez les méthodes dans la classe Debug pour imprimer les informations de débogage et vérifier votre logique avec des assertions, vous pouvez renforcer votre code sans influer sur la performance ni sur la taille du code de votre produit d'envoi.

Dans les projets Visual Studio 2005, la création d'une version debug active Debug. Pour plus d'informations sur la façon de désactiver Debug, consultez la documentation de Visual Studio 2005.

En revanche, dans les projets Visual Studio 2005, Trace est activé par défaut aussi bien pour les versions release que debug, ce qui fait que le code est généré pour toutes les méthodes de traçage dans les versions release et debug. Vous pouvez par conséquent utiliser Trace pour instrumenter des versions release.

Cette classe fournit des méthodes d'affichage d'une boîte de dialogue Assert et permet d'envoyer une assertion qui échouera toujours. 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 Commutateurs de traçage.

Vous pouvez personnaliser la cible de la sortie du traçage en ajoutant ou supprimant des instances de TraceListener de la collection Listeners. Par défaut, la classe DefaultTraceListener émet une sortie de traçage.

Vous pouvez modifier le niveau de mise en retrait à l'aide de la méthode Indent ou de la propriété IndentLevel. Pour modifier la largeur de l'espace de retrait, utilisez la propriété IndentSize. Vous pouvez spécifier le vidage automatique de la mémoire tampon de sortie après chaque écriture en affectant à la propriété AutoFlush la valeur true.

Pour définir les valeurs AutoFlush et IndentSize pour Debug, 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="true" indentsize="7" />
     </system.diagnostics>
  </configuration>
RemarqueRemarque

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 fournir une fonction équivalente en C++, vous devez englober les appels aux méthodes de cette classe dans un bloc #ifdef DEBUG... #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 Debug.

L'exemple suivant utilise Debug 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)
{
   Debug.Listeners.Add(new TextWriterTraceListener(Console.Out));
   Debug.AutoFlush = true;
   Debug.Indent();
   Debug.WriteLine("Entering Main");
   Console.WriteLine("Hello World.");
   Debug.WriteLine("Exiting Main"); 
   Debug.Unindent();
   return 0;
}


System.Object
  System.Diagnostics.Debug

Type sécurisé pour les opérations multithread.

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
Afficher:
© 2014 Microsoft