Debug Classe

Définition

public ref class Debug abstract sealed

public ref class Debug sealed

public static class Debug

public sealed class Debug

type Debug = class

Public Class Debug

Public NotInheritable Class Debug

Héritage

Object

Debug

Exemples

L’exemple suivant utilise Debug pour indiquer le début et la fin de l’exécution d’un programme. L’exemple utilise Indent également et Unindent distingue la sortie de suivi.

// Specify /d:DEBUG when compiling.

using System;
using System.Data;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       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();
    }
}

' Specify /d:DEBUG=True when compiling.

Imports System.Data
Imports System.Diagnostics

Class Test

    Shared Sub Main()
    
        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()
        
    End Sub
    
End Class

Remarques

Pour rendre votre code plus robuste sans affecter les performances et la taille du code de votre produit d’expédition, utilisez des méthodes dans la Debug classe pour imprimer les informations de débogage et vérifier votre logique avec des assertions.

Cette classe fournit des méthodes pour afficher une Assert boîte de dialogue et émettre une assertion qui échouera toujours. Cette classe fournit des méthodes d’écriture dans les variantes suivantes :

• Write
• WriteLine
• WriteIf
• WriteLineIf

Les BooleanSwitch classes et TraceSwitch les classes fournissent des moyens de contrôler dynamiquement la sortie de suivi. Pour les applications .NET Framework, 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 dans les applications .NET Framework, consultez la Switch classe et l’article Trace Switchs .

Vous pouvez personnaliser la cible de la sortie de suivi en ajoutant TraceListener ou en supprimant des instances de la Listeners collection. La Listeners collection est partagée à la fois par les classes et par l’ajout DebugTrace d’un écouteur de trace à l’une ou l’autre classe ajoute l’écouteur aux deux. Par défaut, la DefaultTraceListener classe émet une sortie de trace.

Vous pouvez modifier le niveau de retrait à l’aide de la Indent méthode ou de la IndentLevel propriété. Pour modifier l’espacement du retrait, utilisez la IndentSize propriété. Vous pouvez spécifier s’il faut vider automatiquement la mémoire tampon de sortie après chaque écriture en définissant la AutoFlush propriété truesur .

Pour les applications .NET Framework, vous pouvez définir et pour Debug cela en modifiant le AutoFlushIndentSize fichier de configuration de votre application. Le fichier de configuration doit être mis en forme comme indiqué dans l’exemple suivant.

<configuration>
  <system.diagnostics>
    <trace autoflush="true" indentsize="7" />
  </system.diagnostics>
</configuration>

L’attribut ConditionalAttribute est appliqué aux méthodes de Debug. Les compilateurs qui prennent en charge ConditionalAttribute l’ignorer les appels à ces méthodes, sauf s’ils DEBUG sont définis comme symbole de compilation conditionnelle. Reportez-vous à la documentation d’un compilateur pour déterminer si ConditionalAttribute elle est prise en charge et la syntaxe permettant de définir un symbole de compilation conditionnelle.

Pour définir le DEBUG symbole de compilation conditionnelle en C#, ajoutez l’option /d:DEBUG à la ligne de commande du compilateur lorsque vous compilez votre code à l’aide d’une ligne de commande ou ajoutez-y #define DEBUG en haut de votre fichier. Dans Visual Basic, ajoutez l’option /d:DEBUG=True à la ligne de commande du compilateur ou ajoutez-y #Const DEBUG=True .

Cohérence de thread

Ce type est thread safe.

Voir aussi

• Trace
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute