Debug Class

Provides a set of methods and properties that help debug your code. This class cannot be inherited.

System.Object
  System.Diagnostics.Debug

Namespace:  System.Diagnostics
Assembly:  System (in System.dll)

'Declaration
Public NotInheritable Class Debug

The Debug type exposes the following members.

  NameDescription
Public propertyStatic memberSupported by the XNA FrameworkAutoFlushGets or sets a value indicating whether Flush should be called on the Listeners after every write.
Public propertyStatic memberSupported by the XNA FrameworkIndentLevelGets or sets the indent level.
Public propertyStatic memberSupported by the XNA FrameworkIndentSizeGets or sets the number of spaces in an indent.
Public propertyStatic memberSupported by the XNA FrameworkListenersGets the collection of listeners that is monitoring the debug output.
Top

  NameDescription
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsAssert(Boolean)Checks for a condition; if the condition is false, displays a message box that shows the call stack.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsAssert(Boolean, String)Checks for a condition; if the condition is false, outputs a specified message and displays a message box that shows the call stack.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibraryAssert(Boolean, String, String)Checks for a condition; if the condition is false, outputs two specified messages and displays a message box that shows the call stack.
Public methodStatic memberAssert(Boolean, String, String, Object())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.
Public methodStatic memberSupported by the XNA FrameworkCloseFlushes the output buffer and then calls the Close method on each of the Listeners.
Public methodStatic memberSupported by the XNA FrameworkFail(String)Emits the specified error message.
Public methodStatic memberSupported by the XNA FrameworkFail(String, String)Emits an error message and a detailed error message.
Public methodStatic memberSupported by the XNA FrameworkFlushFlushes the output buffer and causes buffered data to write to the Listeners collection.
Public methodStatic memberIndentIncreases the current IndentLevel by one.
Public methodStatic memberPrint(String)Writes a message followed by a line terminator to the trace listeners in the Listeners collection.
Public methodStatic memberPrint(String, Object())Writes a formatted string followed by a line terminator to the trace listeners in the Listeners collection.
Public methodStatic memberUnindentDecreases the current IndentLevel by one.
Public methodStatic memberSupported by the XNA FrameworkWrite(Object)Writes the value of the object's ToString method to the trace listeners in the Listeners collection.
Public methodStatic memberSupported by the XNA FrameworkWrite(String)Writes a message to the trace listeners in the Listeners collection.
Public methodStatic memberSupported by the XNA FrameworkWrite(Object, String)Writes a category name and the value of the object's ToString method to the trace listeners in the Listeners collection.
Public methodStatic memberSupported by the XNA FrameworkWrite(String, String)Writes a category name and message to the trace listeners in the Listeners collection.
Public methodStatic memberSupported by the XNA FrameworkWriteIf(Boolean, Object)Writes the value of the object's ToString method to the trace listeners in the Listeners collection if a condition is true.
Public methodStatic memberSupported by the XNA FrameworkWriteIf(Boolean, String)Writes a message to the trace listeners in the Listeners collection if a condition is true.
Public methodStatic memberSupported by the XNA FrameworkWriteIf(Boolean, Object, String)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.
Public methodStatic memberSupported by the XNA FrameworkWriteIf(Boolean, String, String)Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsWriteLine(Object)Writes the value of the object's ToString method to the trace listeners in the Listeners collection.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsWriteLine(String)Writes a message followed by a line terminator to the trace listeners in the Listeners collection.
Public methodStatic memberSupported by the XNA FrameworkWriteLine(Object, String)Writes a category name and the value of the object's ToString method to the trace listeners in the Listeners collection.
Public methodStatic memberSupported by Portable Class LibrarySupported in .NET for Windows Store appsWriteLine(String, Object())Writes a formatted message followed by a line terminator to the trace listeners in the Listeners collection.
Public methodStatic memberSupported by the XNA FrameworkWriteLine(String, String)Writes a category name and message to the trace listeners in the Listeners collection.
Public methodStatic memberSupported by the XNA FrameworkWriteLineIf(Boolean, Object)Writes the value of the object's ToString method to the trace listeners in the Listeners collection if a condition is true.
Public methodStatic memberSupported by the XNA FrameworkSupported by Portable Class LibrarySupported in .NET for Windows Store appsWriteLineIf(Boolean, String)Writes a message to the trace listeners in the Listeners collection if a condition is true.
Public methodStatic memberSupported by the XNA FrameworkWriteLineIf(Boolean, Object, String)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.
Public methodStatic memberSupported by the XNA FrameworkWriteLineIf(Boolean, String, String)Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.
Top

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.

This class provides methods to display an Assert dialog box, and to emit an assertion that will always fail. This class provides write methods in the following variations: Write, WriteLine, WriteIf and WriteLineIf.

The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. You can modify the values of these switches without recompiling your application. For information on using the configuration file to set a switch, see the Switch class and the Trace Switches topic.

You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. 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. By default, the DefaultTraceListener class emits trace output.

NoteNote

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. The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. It may be useful to place calls to the Debug methods in try/catch blocks to detect and handle any exceptions from trace listeners.

You can modify the level of indentation using the Indent method or the IndentLevel property. To modify the indent spacing, use the IndentSize property. You can specify whether to automatically flush the output buffer after each write by setting the AutoFlush property to true.

To set the AutoFlush and IndentSize for Debug, you can edit the configuration file corresponding to the name of your application. The configuration file should be formatted as shown in the following example.

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

The ConditionalAttribute attribute is applied to the methods of Debug. Compilers that support ConditionalAttribute ignore calls to these methods unless "DEBUG" is defined as a conditional compilation symbol. Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

NoteNote

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. For information about how to disable this behavior, see the Visual Studio documentation. For information about conditional debugging in Visual C++, see Debug Class (C++/CLI).

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, add the /d:DEBUG=True option to the compiler command line or add #Const DEBUG=True to the file.

The following example uses Debug to indicate the beginning and end of a program's execution. The example also uses Indent and Unindent to distinguish the tracing output.

' 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

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

This type is thread safe.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft