Debug Classe

Definizione

Fornisce un set di metodi e proprietà che consentono di eseguire il debug del codice.Provides a set of methods and properties that help debug your code.

public ref class Debug abstract sealed
public static class Debug
type Debug = class
Public Class Debug
Ereditarietà
Debug

Esempi

Nell'esempio seguente viene Debug usato per indicare l'inizio e la fine dell'esecuzione di un programma.The following example uses Debug to indicate the beginning and end of a program's execution. Nell'esempio vengono inoltre Indent utilizzati Unindent e per distinguere l'output di traccia.The example also uses Indent and Unindent to distinguish the tracing output.

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

Se si usano i Debug metodi nella classe per stampare le informazioni di debug e verificare la logica con le asserzioni, è possibile rendere il codice più affidabile senza influisca sulle prestazioni e sulle dimensioni del codice del prodotto di spedizione.If you use methods in the Debug class to print debugging information and check your logic with assertions, you can make your code more robust without impacting the performance and code size of your shipping product.

Questa classe fornisce i metodi per visualizzare Assert una finestra di dialogo e per generare un'asserzione che avrà sempre esito negativo.This class provides methods to display an Assert dialog box, and to emit an assertion that will always fail. Questa classe fornisce metodi di scrittura nelle varianti seguenti: Write WriteIf , WriteLinee WriteLineIf.This class provides write methods in the following variations: Write, WriteLine, WriteIf and WriteLineIf.

Le BooleanSwitch classi TraceSwitch e forniscono mezzi per controllare dinamicamente l'output di traccia.The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. È possibile modificare i valori di queste opzioni senza ricompilare l'applicazione.You can modify the values of these switches without recompiling your application. Per informazioni sull'uso del file di configurazione per impostare un'opzione, vedere Switch l'argomento relativo alla classe e alle Opzioni di traccia .For information on using the configuration file to set a switch, see the Switch class and the Trace Switches topic.

Per personalizzare la destinazione dell'output di traccia, è TraceListener possibile aggiungere o rimuovere istanze Listeners dalla raccolta.You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. La Listeners raccolta è condivisa dalle Debug Trace classi e. l'aggiunta di un listener di traccia a una delle due classi aggiunge il listener a entrambi.The Listeners collection is shared by both the Debug and the Trace classes; adding a trace listener to either class adds the listener to both. Per impostazione predefinita, DefaultTraceListener la classe genera l'output di traccia.By default, the DefaultTraceListener class emits trace output.

Nota

L'aggiunta di un listener di Listeners traccia alla raccolta può provocare la generazione di un'eccezione durante la traccia, se non è disponibile una risorsa utilizzata dal listener di traccia.Adding a trace listener to the Listeners collection can cause an exception to be thrown while tracing, if a resource used by the trace listener is not available. Le condizioni e l'eccezione generata dipendono dal listener di traccia e non possono essere enumerate in questo argomento.The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. Può essere utile inserire Debug le chiamate ai metodi nei try / catch blocchi per rilevare e gestire le eccezioni dai listener di traccia.It may be useful to place calls to the Debug methods in try/catch blocks to detect and handle any exceptions from trace listeners.

È possibile modificare il livello di rientro utilizzando il Indent metodo o la IndentLevel proprietà.You can modify the level of indentation using the Indent method or the IndentLevel property. Per modificare la spaziatura dei rientri IndentSize , utilizzare la proprietà.To modify the indent spacing, use the IndentSize property. È possibile specificare se scaricare automaticamente il buffer di output dopo ogni scrittura impostando la AutoFlush proprietà su true.You can specify whether to automatically flush the output buffer after each write by setting the AutoFlush property to true.

Per impostare AutoFlush e IndentSize per Debug, è possibile modificare il file di configurazione corrispondente al nome dell'applicazione.To set the AutoFlush and IndentSize for Debug, you can edit the configuration file corresponding to the name of your application. Il file di configurazione deve essere formattato come illustrato nell'esempio seguente.The configuration file should be formatted as shown in the following example.

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

L' ConditionalAttribute attributo viene applicato ai metodi di Debug.The ConditionalAttribute attribute is applied to the methods of Debug. I compilatori ConditionalAttribute che supportano ignorare le chiamate a questi metodi a meno che "debug" non sia definito come simbolo di compilazione condizionale.Compilers that support ConditionalAttribute ignore calls to these methods unless "DEBUG" is defined as a conditional compilation symbol. Per determinare se ConditionalAttribute è supportato e la sintassi per la definizione di un simbolo di compilazione condizionale, fare riferimento alla documentazione del compilatore.Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

Nota

Nei progetti Visual C# Studio e Visual Basic, per impostazione predefinita, viene definito il simbolo di compilazione condizionale "debug" per le compilazioni di debug e il simbolo "Trace" viene definito per le compilazioni di debug e di rilascio.In Visual Studio C# and Visual Basic projects, by default, the "DEBUG" conditional compilation symbol is defined for debug builds, and the "TRACE" symbol is defined for both debug and release builds. Per informazioni su come disabilitare questo comportamento, vedere la documentazione di Visual Studio.For information about how to disable this behavior, see the Visual Studio documentation. Per informazioni sul debug condizionale in C++Visual, vedere classe debugC++(/CLI).For information about conditional debugging in Visual C++, see Debug Class (C++/CLI).

Per definire il simbolo di compilazione condizionale "debug C#" in, /d:DEBUG aggiungere l'opzione alla riga di comando del compilatore quando si compila il codice tramite una riga di #define DEBUG comando o aggiungere all'inizio del file.To define the "DEBUG" conditional compilation symbol in C#, add the /d:DEBUG option to the compiler command line when you compile your code using a command line, or add #define DEBUG to the top of your file. In Visual Basic aggiungere l' /d:DEBUG=True opzione alla riga di comando del compilatore o aggiungere #Const DEBUG=True al file.In Visual Basic, add the /d:DEBUG=True option to the compiler command line or add #Const DEBUG=True to the file.

Proprietà

AutoFlush

Ottiene o imposta un valore che indica se chiamare il metodo Flush() sulla proprietà Listeners dopo ogni operazione di scrittura.Gets or sets a value indicating whether Flush() should be called on the Listeners after every write.

IndentLevel

Ottiene o imposta il livello di rientro.Gets or sets the indent level.

IndentSize

Ottiene o imposta il numero di spazi in un rientro.Gets or sets the number of spaces in an indent.

Listeners

Ottiene l'insieme di listener che esegue il monitoraggio dell'output di debug.Gets the collection of listeners that is monitoring the debug output.

Metodi

Assert(Boolean)

Controlla una condizione. Se la condizione è false, viene visualizzata una finestra di messaggio contenente lo stack di chiamate.Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String)

Controlla una condizione. Se la condizione è false, genera un messaggio specificato e visualizza una finestra di messaggio contenente lo stack di chiamate.Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.

Assert(Boolean, String, String)

Controlla una condizione. Se la condizione è false, vengono generati due messaggi specificati e viene visualizzata una finestra di messaggio contenente lo stack di chiamate.Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.

Assert(Boolean, String, String, Object[])

Controlla una condizione. Se la condizione è false, vengono generati due messaggi (semplice e formattato) e viene visualizzata una finestra di messaggio contenente lo stack di chiamate.Checks for a condition; if the condition is false, outputs two messages (simple and formatted) and displays a message box that shows the call stack.

Close()

Svuota il buffer dell'output e quindi chiama il metodo Close per ogni Listeners.Flushes the output buffer and then calls the Close method on each of the Listeners.

Fail(String)

Genera il messaggio di errore specificato.Emits the specified error message.

Fail(String, String)

Genera un messaggio di errore e un messaggio di errore dettagliato.Emits an error message and a detailed error message.

Flush()

Svuota il buffer di output e determina la scrittura dei dati del buffer nell'insieme Listeners.Flushes the output buffer and causes buffered data to write to the Listeners collection.

Indent()

Incrementa la proprietà IndentLevel corrente di uno.Increases the current IndentLevel by one.

Print(String)

Scrive un messaggio seguito da un terminatore di riga nei listener di traccia nell'insieme Listeners.Writes a message followed by a line terminator to the trace listeners in the Listeners collection.

Print(String, Object[])

Scrive una stringa formattata seguita da un terminatore di riga nei listener di traccia dell'insieme Listeners.Writes a formatted string followed by a line terminator to the trace listeners in the Listeners collection.

Unindent()

Riduce la proprietà IndentLevel corrente di uno.Decreases the current IndentLevel by one.

Write(Object)

Scrive il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(Object, String)

Scrive il nome di una categoria e il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(String)

Scrive un messaggio nei listener di traccia dell'insieme Listeners.Writes a message to the trace listeners in the Listeners collection.

Write(String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia dell'insieme Listeners.Writes a category name and message to the trace listeners in the Listeners collection.

WriteIf(Boolean, Object)

Scrive il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners, se una condizione è true.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, Object, String)

Scrive il nome di una categoria e il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String)

Scrive un messaggio nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

WriteLine(Object)

Scrive il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(Object, String)

Scrive il nome di una categoria e il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String)

Scrive un messaggio seguito da un terminatore di riga nei listener di traccia nell'insieme Listeners.Writes a message followed by a line terminator to the trace listeners in the Listeners collection.

WriteLine(String, Object[])

Scrive un messaggio formattato seguito da un terminatore di riga nei listener di traccia nell'insieme Listeners.Writes a formatted message followed by a line terminator to the trace listeners in the Listeners collection.

WriteLine(String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia dell'insieme Listeners.Writes a category name and message to the trace listeners in the Listeners collection.

WriteLineIf(Boolean, Object)

Scrive il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners, se una condizione è true.Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, Object, String)

Scrive il nome di una categoria e il valore del metodo ToString() dell'oggetto nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String)

Scrive un messaggio nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String, String)

Scrive un nome di categoria e un messaggio nei listener di traccia dell'insieme Listeners se una condizione è true.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

Si applica a

Thread safety

Questo tipo è thread-safe.This type is thread safe.

Vedi anche