Debug Classe

Definição

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

Herança

Object

Debug

Exemplos

O exemplo a seguir usa Debug para indicar o início e o fim da execução de um programa. O exemplo também usa Indent e Unindent para distinguir a saída de rastreamento.

// 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

Comentários

Para tornar seu código mais robusto sem afetar o desempenho e o tamanho do código do produto de envio, use métodos na Debug classe para imprimir informações de depuração e marcar sua lógica com declarações.

Essa classe fornece métodos para exibir uma Assert caixa de diálogo e emitir uma declaração que sempre falhará. Essa classe fornece métodos de gravação nas seguintes variações:

• Write
• WriteLine
• WriteIf
• WriteLineIf

As BooleanSwitch classes e TraceSwitch fornecem meios para controlar dinamicamente a saída de rastreamento. Para aplicativos .NET Framework, você pode modificar os valores desses comutadores sem recompilar seu aplicativo. Para obter informações sobre como usar o arquivo de configuração para definir uma opção em aplicativos .NET Framework, consulte a Switch classe e o artigo Opções de Rastreamento.

Você pode personalizar o destino da saída de rastreamento adicionando TraceListener instâncias ou removendo instâncias da Listeners coleção. A Listeners coleção é compartilhada pelas Debug classes e Trace , a adição de um ouvinte de rastreamento a qualquer classe adiciona o ouvinte a ambos. Por padrão, a classe emite a DefaultTraceListener saída de rastreamento.

Você pode modificar o nível de recuo usando o Indent método ou a IndentLevel propriedade . Para modificar o espaçamento de recuo, use a IndentSize propriedade . Você pode especificar se deseja liberar automaticamente o buffer de saída após cada gravação definindo a AutoFlush propriedade como true.

Para .NET Framework aplicativos, você pode definir o e IndentSize para Debug editando o AutoFlush arquivo de configuração do aplicativo. O arquivo de configuração deve ser formatado conforme mostrado no exemplo a seguir.

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

O ConditionalAttribute atributo é aplicado aos métodos de Debug. Os compiladores que dão suporte ConditionalAttribute a ignorar chamadas a esses métodos DEBUG , a menos que seja definido como um símbolo de compilação condicional. Consulte a documentação de um compilador para determinar se ConditionalAttribute há suporte e a sintaxe para definir um símbolo de compilação condicional.

Para definir o DEBUG símbolo de compilação condicional em C#, adicione a opção /d:DEBUG à linha de comando do compilador ao compilar seu código usando uma linha de comando ou adicione #define DEBUG à parte superior do arquivo. No Visual Basic, adicione a opção /d:DEBUG=True à linha de comando do compilador ou adicione #Const DEBUG=True ao arquivo.

Propriedades

Métodos

Aplica-se a

Acesso thread-safe

Este tipo é thread-safe.

Confira também

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