Debug Debug Debug Debug Class

Definition

Stellt eine Reihe von Methoden und Eigenschaften zum Debuggen von Code bereit. 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
Vererbung
DebugDebugDebugDebug

Beispiele

Im folgenden Beispiel wird Debug Anfang und Ende der Ausführung des Programms an.The following example uses Debug to indicate the beginning and end of a program's execution. Im Beispiel verwendet auch Indent und Unindent um die Ausgabe der Ablaufverfolgung zu unterscheiden.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
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

Hinweise

Bei Verwendung von Methoden in der Debug Klasse, um Debuginformationen zu drucken und die Logik mit Assertionen, Sie können Ihren Code stabiler machen, ohne Auswirkungen auf die Leistung und Größe des Endprodukts.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.

Diese Klasse stellt Methoden zum Anzeigen einer Assert Dialogfeld und eine Assertion auszugeben, die immer fehlschlägt.This class provides methods to display an Assert dialog box, and to emit an assertion that will always fail. Diese Klasse stellt die Write-Methoden in der folgenden Variationen: Write, WriteLine, WriteIf und WriteLineIf.This class provides write methods in the following variations: Write, WriteLine, WriteIf and WriteLineIf.

Die BooleanSwitch und TraceSwitch Klassen bieten die Möglichkeit, die Ablaufverfolgungsausgabe dynamisch zu steuern.The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. Sie können die Werte dieser Schalter ändern, ohne Erneutes Kompilieren der Anwendung.You can modify the values of these switches without recompiling your application. Weitere Informationen zur Verwendung der Konfigurationsdatei zum Festlegen eines Schalters, finden Sie unter der Switch Klasse und die Ablaufverfolgungsschalter Thema.For information on using the configuration file to set a switch, see the Switch class and the Trace Switches topic.

Sie können die Ziel der Ablaufverfolgungsausgabe anpassen, indem hinzufügen TraceListener -Instanzen zu oder Entfernen von Instanzen aus der Listeners Auflistung.You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. Die Listeners Auflistung wird von beiden gemeinsam genutzt der Debug und Trace Klassen; hinzufügen, ein Ablaufverfolgungslistener zur Klasse fügt den Listener für beide.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. In der Standardeinstellung die DefaultTraceListener Klasse gibt die Ausgabe der Ablaufverfolgung.By default, the DefaultTraceListener class emits trace output.

Hinweis

Hinzufügen eines Ablaufverfolgungslisteners, um die Listeners Sammlung kann eine Ausnahme während der Ablaufverfolgung, ausgelöst werden, wenn eine Ressource, die vom Ablaufverfolgungslistener verwendet werden, nicht verfügbar ist.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. Die Bedingungen und die Ausnahme wird ausgelöst, richten sich nach der Ablaufverfolgungs-Listener und können nicht aufgezählt werden, in diesem Thema.The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. Es kann hilfreich sein, platzieren Sie Aufrufe an die Debug Methoden in try / catch zu erkennen und Behandeln von Ausnahmen vom Ablaufverfolgungslistener Blöcke.It may be useful to place calls to the Debug methods in try/catch blocks to detect and handle any exceptions from trace listeners.

Sie können die Ebene der Einzug unter Verwendung der Indent Methode oder der IndentLevel Eigenschaft.You can modify the level of indentation using the Indent method or the IndentLevel property. Um den Einzugsabstand ändern möchten, verwenden die IndentSize Eigenschaft.To modify the indent spacing, use the IndentSize property. Sie können angeben, ob automatisch den Ausgabepuffer nach jedem Schreibvorgang geleert werden durch Festlegen der AutoFlush Eigenschaft true.You can specify whether to automatically flush the output buffer after each write by setting the AutoFlush property to true.

Festlegen der AutoFlush und IndentSize für Debug, Sie können die Konfigurationsdatei mit dem Namen der Anwendung bearbeiten.To set the AutoFlush and IndentSize for Debug, you can edit the configuration file corresponding to the name of your application. Die Konfigurationsdatei sollen wie im folgenden Beispiel gezeigt formatiert werden.The configuration file should be formatted as shown in the following example.

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

Die ConditionalAttribute Attribut angewendet wird, an die-Methoden der Debug.The ConditionalAttribute attribute is applied to the methods of Debug. Compiler, unterstützen ConditionalAttribute Aufrufe dieser Methoden ignoriert, es sei denn, "DEBUG" als Symbol für bedingte Kompilierung definiert werden.Compilers that support ConditionalAttribute ignore calls to these methods unless "DEBUG" is defined as a conditional compilation symbol. Finden Sie in der Dokumentation des Compilers um zu bestimmen, ob ConditionalAttribute wird unterstützt und die Syntax zum Definieren eines Symbols für die bedingte Kompilierung.Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

Hinweis

Klicken Sie in Visual Studio C#- und Visual Basic-Projekten standardmäßig das konditionale kompiliersymbol "DEBUG" für Debug-Builds definiert ist, und für Debug- und Releasebuilds, ist das Symbol "TRACE" definiert.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. Informationen dazu, wie Sie dieses Verhalten zu deaktivieren finden Sie unter Visual Studio-Dokumentation.For information about how to disable this behavior, see the Visual Studio documentation. Weitere Informationen zum bedingten Debuggen in Visual C++ finden Sie unter Debug-Klasse (C++ / CLI).For information about conditional debugging in Visual C++, see Debug Class (C++/CLI).

Fügen Sie das Symbol "DEBUGGEN" für die bedingte Kompilierung in c# zu definieren, die /d:DEBUG option Befehlszeile des Compilers beim Kompilieren von Code mithilfe einer Befehlszeile aus, oder fügen #define DEBUG am Anfang der Datei.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. Fügen Sie in Visual Basic die /d:DEBUG=True -Option in der Befehlszeile des Compilers, oder fügen #Const DEBUG=True in die Datei.In Visual Basic, add the /d:DEBUG=True option to the compiler command line or add #Const DEBUG=True to the file.

Eigenschaften

AutoFlush AutoFlush AutoFlush AutoFlush

Ruft einen Wert ab, der angibt, ob für Flush() nach jedem Schreibvorgang Listeners aufgerufen werden soll, oder legt diesen fest. Gets or sets a value indicating whether Flush() should be called on the Listeners after every write.

IndentLevel IndentLevel IndentLevel IndentLevel

Ruft die Einzugsebene ab oder legt diese fest. Gets or sets the indent level.

IndentSize IndentSize IndentSize IndentSize

Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest. Gets or sets the number of spaces in an indent.

Listeners Listeners Listeners Listeners

Ruft die Auflistung der Listener ab, die die Debugausgabe überwachen. Gets the collection of listeners that is monitoring the debug output.

Methoden

Assert(Boolean) Assert(Boolean) Assert(Boolean) Assert(Boolean)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird ein Meldungsfeld mit der Aufrufliste angezeigt. Checks for a condition; if the condition is false, displays a message box that shows the call stack.

Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String) Assert(Boolean, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, wird eine angegebene Meldung ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt. 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) Assert(Boolean, String, String) Assert(Boolean, String, String) Assert(Boolean, String, String)

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden zwei angegebene Meldungen ausgegeben, und es wird ein Meldungsfeld mit der Aufrufliste angezeigt. 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[]) Assert(Boolean, String, String, Object[]) Assert(Boolean, String, String, Object[]) Assert(Boolean, String, String, Object[])

Überprüft eine Bedingung. Wenn die Bedingung false ist, werden zwei angegebene Meldungen (einfach und formatiert) ausgegeben, und ein Meldungsfeld mit der Aufrufliste wird angezeigt. 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() Close() Close() Close()

Leert den Ausgabepuffer und ruft dann für jeden Listeners die Close-Methode auf. Flushes the output buffer and then calls the Close method on each of the Listeners.

Fail(String) Fail(String) Fail(String) Fail(String)

Gibt die angegebene Fehlermeldung aus. Emits the specified error message.

Fail(String, String) Fail(String, String) Fail(String, String) Fail(String, String)

Gibt eine Fehlermeldung und eine detaillierte Fehlermeldung aus. Emits an error message and a detailed error message.

Flush() Flush() Flush() Flush()

Leert den Ausgabepuffer und veranlasst das Schreiben der gepufferten Daten in die Listeners-Auflistung. Flushes the output buffer and causes buffered data to write to the Listeners collection.

Indent() Indent() Indent() Indent()

Erhöht die aktuelle IndentLevel um 1. Increases the current IndentLevel by one.

Print(String) Print(String) Print(String) Print(String)

Schreibt eine Meldung, gefolgt von einem Zeilenabschluss, in die Ablaufverfolgungsüberwachungen in der Listeners-Auflistung. Writes a message followed by a line terminator to the trace listeners in the Listeners collection.

Print(String, Object[]) Print(String, Object[]) Print(String, Object[]) Print(String, Object[])

Schreibt eine formatierte Zeichenfolge, gefolgt von einem Zeilenabschluss, in die Ablaufverfolgungsüberwachungen in der Listeners-Auflistung. Writes a formatted string followed by a line terminator to the trace listeners in the Listeners collection.

Unindent() Unindent() Unindent() Unindent()

Verringert die aktuelle IndentLevel um 1. Decreases the current IndentLevel by one.

Write(String, String) Write(String, String) Write(String, String) Write(String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung. Writes a category name and message to the trace listeners in the Listeners collection.

Write(Object, String) Write(Object, String) Write(Object, String) Write(Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode des Objekts in den Ablaufverfolgungslistener in der Listeners-Auflistung. Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(Object) Write(Object) Write(Object) Write(Object)

Schreibt den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung. Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

Write(String) Write(String) Write(String) Write(String)

Schreibt eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung. Writes a message to the trace listeners in the Listeners collection.

WriteIf(Boolean, Object) WriteIf(Boolean, Object) WriteIf(Boolean, Object) WriteIf(Boolean, Object)

Schreibt den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist. Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, String) WriteIf(Boolean, String) WriteIf(Boolean, String) WriteIf(Boolean, String)

Schreibt eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist. Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String) WriteIf(Boolean, Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist. 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, String) WriteIf(Boolean, String, String) WriteIf(Boolean, String, String) WriteIf(Boolean, String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist. Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

WriteLine(Object) WriteLine(Object) WriteLine(Object) WriteLine(Object)

Schreibt den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung. Writes the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String) WriteLine(String) WriteLine(String) WriteLine(String)

Schreibt eine Meldung, gefolgt von einem Zeilenabschluss, in die Ablaufverfolgungsüberwachungen in der Listeners-Auflistung. Writes a message followed by a line terminator to the trace listeners in the Listeners collection.

WriteLine(Object, String) WriteLine(Object, String) WriteLine(Object, String) WriteLine(Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode des Objekts in den Ablaufverfolgungslistener in der Listeners-Auflistung. Writes a category name and the value of the object's ToString() method to the trace listeners in the Listeners collection.

WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[]) WriteLine(String, Object[])

Schreibt eine formatierte Meldung, gefolgt von einem Zeilenabschluss, in die Ablaufverfolgungslistener in der Listeners-Auflistung. Writes a formatted message followed by a line terminator to the trace listeners in the Listeners collection.

WriteLine(String, String) WriteLine(String, String) WriteLine(String, String) WriteLine(String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung. Writes a category name and message to the trace listeners in the Listeners collection.

WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String) WriteLineIf(Boolean, Object, String)

Schreibt einen Kategorienamen und den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist. 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, Object) WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object)

Schreibt den Wert der ToString()-Methode des Objekts in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist. Writes the value of the object's ToString() method to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String)

Schreibt eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist. Writes a message to the trace listeners in the Listeners collection if a condition is true.

WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String) WriteLineIf(Boolean, String, String)

Schreibt einen Kategorienamen und eine Meldung in die Ablaufverfolgungslistener in der Listeners-Auflistung, wenn eine Bedingung true ist. Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher. This type is thread safe.

Siehe auch