Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase Debug

 

Proporciona un conjunto de métodos y propiedades que ayudan a depurar el código.

Espacio de nombres:   System.Diagnostics
Ensamblado:  System (en System.dll)

System::Object
  System.Diagnostics::Debug

public ref class Debug abstract sealed 

NombreDescripción
System_CAPS_pubpropertySystem_CAPS_staticAutoFlush

Obtiene o establece un valor que indica si Flush se debe llamar en el Listeners después de cada escritura.

System_CAPS_pubpropertySystem_CAPS_staticIndentLevel

Obtiene o establece el nivel de sangría.

System_CAPS_pubpropertySystem_CAPS_staticIndentSize

Obtiene o establece el número de espacios de una sangría.

System_CAPS_pubpropertySystem_CAPS_staticListeners

Obtiene la colección de agentes de escucha que está supervisando los resultados de depuración.

NombreDescripción
System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean)

Comprueba una condición; si la condición es false, aparece un cuadro de mensaje que muestra la pila de llamadas.

System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean, String^)

Comprueba una condición; si la condición es false, genera un mensaje especificado y muestra un cuadro de mensaje que muestra la pila de llamadas.

System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean, String^, String^)

Comprueba una condición; si la condición es false, genera dos mensajes especificados y muestra un cuadro de mensaje que muestra la pila de llamadas.

System_CAPS_pubmethodSystem_CAPS_staticAssert(Boolean, String^, String^, array<Object^>^)

Comprueba una condición; Si la condición es false, muestra dos mensajes (simples y con formato) y presenta un cuadro de mensaje que muestra la pila de llamadas.

System_CAPS_pubmethodSystem_CAPS_staticClose()

Vacía el búfer de salida y, a continuación, llama el Close método en cada uno de los Listeners.

System_CAPS_pubmethodSystem_CAPS_staticFail(String^)

Emite el mensaje de error especificado.

System_CAPS_pubmethodSystem_CAPS_staticFail(String^, String^)

Emite un mensaje de error y un mensaje de error detallado.

System_CAPS_pubmethodSystem_CAPS_staticFlush()

Vacía el búfer de salida y hace que los datos almacenados en búfer se escriban en la colección Listeners.

System_CAPS_pubmethodSystem_CAPS_staticIndent()

Aumenta el IndentLevel actual en uno.

System_CAPS_pubmethodSystem_CAPS_staticPrint(String^)

Escribe un mensaje seguido de un terminador de línea en los agentes de escucha de seguimiento en el Listeners colección.

System_CAPS_pubmethodSystem_CAPS_staticPrint(String^, array<Object^>^)

Escribe una cadena con formato seguida de un terminador de línea en los agentes de escucha de seguimiento en el Listeners colección.

System_CAPS_pubmethodSystem_CAPS_staticUnindent()

Disminuye el IndentLevel actual en uno.

System_CAPS_pubmethodSystem_CAPS_staticWrite(Object^)

Escribe el valor del objeto ToString método a los agentes de escucha de seguimiento en el Listeners colección.

System_CAPS_pubmethodSystem_CAPS_staticWrite(Object^, String^)

Escribe un nombre de categoría y el valor del objeto ToString método a los agentes de escucha de seguimiento en el Listeners colección.

System_CAPS_pubmethodSystem_CAPS_staticWrite(String^)

Escribe un mensaje en los agentes de escucha de seguimiento en el Listeners colección.

System_CAPS_pubmethodSystem_CAPS_staticWrite(String^, String^)

Escribe un mensaje y un nombre de categoría a los agentes de escucha de seguimiento de la colección Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, Object^)

Escribe el valor del objeto ToString método a los agentes de escucha de seguimiento en el Listeners colección si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, Object^, String^)

Escribe un nombre de categoría y el valor del objeto ToString método a los agentes de escucha de seguimiento en el Listeners colección si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, String^)

Escribe un mensaje en los agentes de escucha de seguimiento en el Listeners colección si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteIf(Boolean, String^, String^)

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento en el Listeners colección si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(Object^)

Escribe el valor del objeto ToString método a los agentes de escucha de seguimiento en el Listeners colección.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(Object^, String^)

Escribe un nombre de categoría y el valor del objeto ToString método a los agentes de escucha de seguimiento en el Listeners colección.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(String^)

Escribe un mensaje seguido de un terminador de línea en los agentes de escucha de seguimiento en el Listeners colección.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(String^, array<Object^>^)

Escribe un mensaje con formato seguido de un terminador de línea en los agentes de escucha de seguimiento en el Listeners colección.

System_CAPS_pubmethodSystem_CAPS_staticWriteLine(String^, String^)

Escribe un mensaje y un nombre de categoría a los agentes de escucha de seguimiento de la colección Listeners.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, Object^)

Escribe el valor del objeto ToString método a los agentes de escucha de seguimiento en el Listeners colección si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, Object^, String^)

Escribe un nombre de categoría y el valor del objeto ToString método a los agentes de escucha de seguimiento en el Listeners colección si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, String^)

Escribe un mensaje en los agentes de escucha de seguimiento en el Listeners colección si una condición es true.

System_CAPS_pubmethodSystem_CAPS_staticWriteLineIf(Boolean, String^, String^)

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento en el Listeners colección si una condición es true.

If you use methods in the T:System.Diagnostics.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 M:System.Diagnostics.Debug.Assert(System.Boolean) dialog box, and to emit an assertion that will always fail. This class provides write methods in the following variations: M:System.Diagnostics.Debug.Write(System.String), M:System.Diagnostics.Debug.WriteLine(System.String), M:System.Diagnostics.Debug.WriteIf(System.Boolean,System.String) and M:System.Diagnostics.Debug.WriteLineIf(System.Boolean,System.String).

The T:System.Diagnostics.BooleanSwitch and T:System.Diagnostics.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 T:System.Diagnostics.Switch class and the Trace Switches topic.

You can customize the tracing output's target by adding T:System.Diagnostics.TraceListener instances to or removing instances from the P:System.Diagnostics.Debug.Listeners collection. The P:System.Diagnostics.Debug.Listeners collection is shared by both the T:System.Diagnostics.Debug and the T:System.Diagnostics.Trace classes; adding a trace listener to either class adds the listener to both. By default, the T:System.Diagnostics.DefaultTraceListener class emits trace output.

System_CAPS_noteNota

Adding a trace listener to the P:System.Diagnostics.Debug.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 T:System.Diagnostics.Debug methods in try/catch blocks to detect and handle any exceptions from trace listeners.

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

To set the P:System.Diagnostics.Debug.AutoFlush and P:System.Diagnostics.Debug.IndentSize for T:System.Diagnostics.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 T:System.Diagnostics.ConditionalAttribute attribute is applied to the methods of T:System.Diagnostics.Debug. Compilers that support T:System.Diagnostics.ConditionalAttribute ignore calls to these methods unless "DEBUG" is defined as a conditional compilation symbol. Refer to a compiler's documentation to determine whether T:System.Diagnostics.ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

System_CAPS_noteNota

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 in Visual C++.

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 T:System.Diagnostics.Debug to indicate the beginning and end of a program's execution. The example also uses M:System.Diagnostics.Debug.Indent and M:System.Diagnostics.Debug.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;
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1

This type is thread safe.

Volver al principio
Mostrar: