Debug Clase

Definición

public ref class Debug abstract sealed

public ref class Debug sealed

public static class Debug

public sealed class Debug

type Debug = class

Public Class Debug

Public NotInheritable Class Debug

Herencia

Object

Debug

Ejemplos

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

Comentarios

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

Las BooleanSwitch TraceSwitch clases y proporcionan medios para controlar dinámicamente los resultados 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 sobre el uso del archivo de configuración para establecer un modificador, vea la Switch clase y el tema modificadores de seguimiento .For information on using the configuration file to set a switch, see the Switch class and the Trace Switches topic.

Puede personalizar el destino del resultado de seguimiento agregando TraceListener instancias a la colección o quitando instancias de la Listeners misma.You can customize the tracing output's target by adding TraceListener instances to or removing instances from the Listeners collection. La Listeners colección se comparte mediante las Debug clases y. al Trace Agregar un agente de escucha de seguimiento a cualquiera de las clases, se 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, la DefaultTraceListener clase emite el resultado del seguimiento.By default, the DefaultTraceListener class emits trace output.

Puede modificar el nivel de sangría mediante 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 se debe vaciar automáticamente el búfer de salida después de cada escritura estableciendo la AutoFlush propiedad en true .You can specify whether to automatically flush the output buffer after each write by setting the AutoFlush property to true.

Para establecer AutoFlush y IndentSize para Debug , puede editar el archivo de configuración que se corresponde con el 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. El archivo de configuración debe tener el formato que se muestra en el ejemplo siguiente.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 llamadas de omisión a estos métodos a menos que "debug" se defina 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.

Para definir el símbolo de compilación condicional "DEBUG" en C#, agregue la /d:DEBUG opción a la línea de comandos del compilador cuando compile el código mediante una línea de comandos, o bien agregue #define DEBUG al principio 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 la /d:DEBUG=True opción a la línea de comandos del compilador o agréguela #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

Métodos

Se aplica a

Seguridad para subprocesos

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

Consulte también

• Trace
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• ConsoleTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute