Debug Debug Debug Debug Class

Definición

Proporciona un conjunto de métodos y propiedades que ayudan a depurar el código.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
Herencia
DebugDebugDebugDebug

Ejemplos

En el ejemplo siguiente se usa Debug para indicar el principio y al final de la ejecución de un programa.The following example uses Debug to indicate the beginning and end of a program's execution. El ejemplo también usa Indent y Unindent para distinguir los resultados de seguimiento.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

Comentarios

Si utiliza métodos en el Debug clase para imprimir la información de depuración y comprobar la lógica con aserciones, puede hacer que el código más sólido sin afectar el tamaño del código y el rendimiento de su producto de trasvase de registros.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.

Esta clase proporciona métodos para mostrar un Assert cuadro de diálogo y para emitir una aserción que siempre se producirá un error.This class provides methods to display an Assert dialog box, and to emit an assertion that will always fail. Esta clase proporciona métodos de escritura en las siguientes variaciones: Write, WriteLine, WriteIf y WriteLineIf.This class provides write methods in the following variations: Write, WriteLine, WriteIf and WriteLineIf.

El BooleanSwitch y TraceSwitch clases proporcionan medios para controlar dinámicamente el resultado del seguimiento.The BooleanSwitch and TraceSwitch classes provide means to dynamically control the tracing output. Puede modificar los valores de estos modificadores sin volver a compilar la aplicación.You can modify the values of these switches without recompiling your application. Para obtener información acerca de cómo utilizar el archivo de configuración para establecer un modificador, vea la Switch clase y el modificadores de seguimiento tema.For information on using the configuration file to set a switch, see the Switch class and the Trace Switches topic.

Puede personalizar el destino de la salida de seguimiento agregando TraceListener instancias o quite instancias de la Listeners colección.You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. El Listeners colección comparten ambos el Debug y Trace clases; agregar un agente de escucha de seguimiento a cualquier clase, agrega el agente de escucha a ambos.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. De forma predeterminada, el DefaultTraceListener clase emite resultados de seguimiento.By default, the DefaultTraceListener class emits trace output.

Nota

Agregar un agente de escucha de seguimiento para el Listeners colección puede producir una excepción que se produzca durante el seguimiento, si un recurso utilizado por el agente de escucha de seguimiento no está disponible.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. Las condiciones y la excepción dependen de la escucha de seguimiento y no se pueden enumerar en este tema.The conditions and the exception thrown depend on the trace listener and cannot be enumerated in this topic. Puede ser útil realizar llamadas a la Debug métodos en try / catch bloques para detectar y controlar las excepciones de los agentes de escucha de seguimiento.It may be useful to place calls to the Debug methods in try/catch blocks to detect and handle any exceptions from trace listeners.

Se puede modificar el nivel de sangría utilizando el Indent método o la IndentLevel propiedad.You can modify the level of indentation using the Indent method or the IndentLevel property. Para modificar el espaciado de sangría, utilice la IndentSize propiedad.To modify the indent spacing, use the IndentSize property. Puede especificar si desea vaciar el búfer de salida de automáticamente después de cada escritura estableciendo el AutoFlush propiedad true.You can specify whether to automatically flush the output buffer after each write by setting the AutoFlush property to true.

Para establecer el AutoFlush y IndentSize para Debug, puede editar el archivo de configuración correspondiente al nombre de la aplicación.To set the AutoFlush and IndentSize for Debug, you can edit the configuration file corresponding to the name of your application. Como se muestra en el ejemplo siguiente, se debe dar formato el archivo de configuración.The configuration file should be formatted as shown in the following example.

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

El ConditionalAttribute atributo se aplica a los métodos de Debug.The ConditionalAttribute attribute is applied to the methods of Debug. Los compiladores que admiten ConditionalAttribute omitir las llamadas a estos métodos, a menos que "DEBUG" se define como un símbolo de compilación condicional.Compilers that support ConditionalAttribute ignore calls to these methods unless "DEBUG" is defined as a conditional compilation symbol. Consulte la documentación del compilador para determinar si ConditionalAttribute se admite y la sintaxis para definir un símbolo de compilación condicional.Refer to a compiler's documentation to determine whether ConditionalAttribute is supported and the syntax for defining a conditional compilation symbol.

Nota

En los proyectos de Visual Studio C# y Visual Basic, de forma predeterminada, se define el símbolo de compilación condicional "DEBUG" para las compilaciones de depuración y se define el símbolo "TRACE" para las versiones de depuración y lanzamiento.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. Para obtener información acerca de cómo deshabilitar este comportamiento, consulte la documentación de Visual Studio.For information about how to disable this behavior, see the Visual Studio documentation. Para obtener información sobre la depuración condicional en Visual C++, vea clase Debug (C++ / c++ / CLI).For information about conditional debugging in Visual C++, see Debug Class (C++/CLI).

Para definir el símbolo de compilación condicional "DEBUG" en C#, agregue el /d:DEBUG opción a la línea de comandos del compilador al compilar el código mediante una línea de comandos o agregar #define DEBUG a la parte superior del archivo.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. En Visual Basic, agregue el /d:DEBUG=True opción a la línea de comandos del compilador o agregue #Const DEBUG=True al archivo.In Visual Basic, add the /d:DEBUG=True option to the compiler command line or add #Const DEBUG=True to the file.

Propiedades

AutoFlush AutoFlush AutoFlush AutoFlush

Obtiene o establece un valor que indica si debe llamarse al método Flush() en la propiedad Listeners después de cada escritura.Gets or sets a value indicating whether Flush() should be called on the Listeners after every write.

IndentLevel IndentLevel IndentLevel IndentLevel

Obtiene o establece el nivel de sangría.Gets or sets the indent level.

IndentSize IndentSize IndentSize IndentSize

Obtiene o establece el número de espacios de una sangría.Gets or sets the number of spaces in an indent.

Listeners Listeners Listeners Listeners

Obtiene la colección de agentes de escucha que está supervisando los resultados de la depuración.Gets the collection of listeners that is monitoring the debug output.

Métodos

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

Comprueba una condición; si la condición es false, aparece un cuadro de mensaje que muestra la pila de llamadas.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)

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.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)

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.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[])

Comprueba una condición; si esta es false, muestra dos mensajes (simple y con formato) y presenta un cuadro de mensaje con la pila de llamadas.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()

Vacía el búfer de resultados y llama al método Close en cada uno de los Listeners.Flushes the output buffer and then calls the Close method on each of the Listeners.

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

Emite el mensaje de error especificado.Emits the specified error message.

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

Emite un mensaje de error y un mensaje de error detallado.Emits an error message and a detailed error message.

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

Vacía el búfer de resultados y hace que los datos almacenados en el búfer se escriban en la colección de Listeners.Flushes the output buffer and causes buffered data to write to the Listeners collection.

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

Aumenta en uno el valor actual de la propiedad IndentLevel.Increases the current IndentLevel by one.

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

Escribe un mensaje seguido de un terminador de línea en los agentes de escucha de seguimiento de la colección de Listeners.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[])

Escribe una cadena con formato seguida de un terminador de línea en los agentes de escucha de seguimiento de la colección de Listeners.Writes a formatted string followed by a line terminator to the trace listeners in the Listeners collection.

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

Disminuye en uno el valor actual de la propiedad IndentLevel.Decreases the current IndentLevel by one.

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

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners.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)

Escribe un nombre de categoría y el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners.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)

Escribe el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners.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)

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners.Writes a message to the trace listeners in the Listeners collection.

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

Escribe el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners si una condición es 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, String) WriteIf(Boolean, String) WriteIf(Boolean, String) WriteIf(Boolean, String)

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.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)

Escribe un nombre de categoría y el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners si una condición es 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, String) WriteIf(Boolean, String, String) WriteIf(Boolean, String, String) WriteIf(Boolean, String, String)

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.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)

Escribe el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners.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)

Escribe un mensaje seguido de un terminador de línea en los agentes de escucha de seguimiento de la colección de Listeners.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)

Escribe un nombre de categoría y el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners.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[])

Escribe un mensaje con formato seguida de un terminador de línea en los agentes de escucha de seguimiento de la colección de Listeners.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)

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners.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)

Escribe un nombre de categoría y el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners si una condición es 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, Object) WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object) WriteLineIf(Boolean, Object)

Escribe el valor del método ToString() del objeto en los agentes de escucha de seguimiento de la colección Listeners si una condición es 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, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String) WriteLineIf(Boolean, String)

Escribe un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.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)

Escribe un nombre de categoría y un mensaje en los agentes de escucha de seguimiento de la colección Listeners si una condición es true.Writes a category name and message to the trace listeners in the Listeners collection if a condition is true.

Se aplica a

Seguridad para subprocesos

Este tipo es seguro para la ejecución de subprocesos.This type is thread safe.

Consulte también: