Debug Classe

Definizione

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

Ereditarietà

Object

Debug

Esempio

Nell'esempio seguente viene Debug usato per indicare l'inizio e la fine dell'esecuzione di un programma. L'esempio usa Indent anche e Unindent per distinguere l'output di traccia.

// Specify /DDEBUG when compiling.

#using <System.dll>
using namespace System;
using namespace System::Diagnostics;

int main( void )
{
   #if defined(DEBUG)
   Debug::Listeners->Add( gcnew TextWriterTraceListener( Console::Out ) );
   Debug::AutoFlush = true;
   Debug::Indent();
   Debug::WriteLine( "Entering Main" );
   #endif
   Console::WriteLine( "Hello World." );
   #if defined(DEBUG)
   Debug::WriteLine( "Exiting Main" );
   Debug::Unindent();
   #endif
   return 0;
}

// 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

Commenti

Per rendere il codice più affidabile senza influire sulle prestazioni e sulle dimensioni del codice del prodotto di spedizione, usare i metodi nella Debug classe per stampare le informazioni di debug e controllare la logica con le asserzioni.

Questa classe fornisce metodi per visualizzare una Assert finestra di dialogo e generare un'asserzione che avrà sempre esito negativo. Questa classe fornisce metodi di scrittura nelle varianti seguenti:

• Write
• WriteLine
• WriteIf
• WriteLineIf

Le BooleanSwitch classi e TraceSwitch forniscono mezzi per controllare dinamicamente l'output di traccia. Per le app .NET Framework, è possibile modificare i valori di queste opzioni senza ricompilare l'applicazione. Per informazioni sull'uso del file di configurazione per impostare un'opzione nelle app .NET Framework, vedere la Switch classe e l'articolo Opzioni di traccia .

È possibile personalizzare la destinazione dell'output di traccia aggiungendo TraceListener o rimuovendo istanze dalla Listeners raccolta. La raccolta viene condivisa sia dalle classi che DebugTrace dalle classi. L'aggiunta Listeners di un listener di traccia a entrambe le classi aggiunge il listener a entrambi. Per impostazione predefinita, la classe genera l'output DefaultTraceListener di traccia.

È possibile modificare il livello di rientro usando il Indent metodo o la IndentLevel proprietà . Per modificare la spaziatura del rientro, utilizzare la IndentSize proprietà . È possibile specificare se scaricare automaticamente il buffer di output dopo ogni scrittura impostando la AutoFlush proprietà su true.

Per le app .NET Framework, è possibile impostare AutoFlush e IndentSize per Debug modificando il file di configurazione dell'app. Il file di configurazione deve essere formattato come illustrato nell'esempio seguente.

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

L'attributo ConditionalAttribute viene applicato ai metodi di Debug. I compilatori che supportano ignorano ConditionalAttribute le chiamate a questi metodi, a meno che non DEBUG sia definito come simbolo di compilazione condizionale. Fare riferimento alla documentazione di un compilatore per determinare se ConditionalAttribute è supportato e la sintassi per la definizione di un simbolo di compilazione condizionale.

Per definire il DEBUG simbolo di compilazione condizionale in C#, aggiungere l'opzione /d:DEBUG alla riga di comando del compilatore quando si compila il codice usando una riga di comando o aggiungere #define DEBUG all'inizio del file. In Visual Basic aggiungere l'opzione /d:DEBUG=True alla riga di comando del compilatore o aggiungere #Const DEBUG=True al file.

Proprietà

Metodi

Si applica a

Thread safety

Questo tipo è thread-safe.

Vedi anche

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