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 seguinte serve Debug para indicar o início e o fim da execução de um programa. O exemplo também utiliza Indent e Unindent para distinguir a saída de traço.

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

Observações

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

Esta classe fornece métodos para mostrar uma Assert caixa de diálogo e emitir uma asserção que falhará sempre. Esta classe fornece métodos de escrita nas seguintes variações:

• Write
• WriteLine
• WriteIf
• WriteLineIf

As BooleanSwitch classes e TraceSwitch fornecem meios para controlar dinamicamente a saída do traçado. Para aplicações .NET Framework, pode modificar os valores destes switches sem ter de recompilar a sua aplicação. Para informações sobre como usar o ficheiro de configuração para definir um switch nas aplicações .NET Framework, consulte a classe Switch e o artigo Trace Switches.

Pode personalizar o destino da saída do rastreio adicionando TraceListener ou removendo instâncias da Listeners coleção. A Listeners coleção é partilhada tanto pelas classes como DebugTrace pelas classes; adicionar um ouvinte de traço a qualquer uma das classes adiciona o ouvinte a ambas. Por defeito, a DefaultTraceListener classe emite saída de traço.

Pode modificar o nível de indentação usando o Indent método ou a IndentLevel propriedade. Para modificar o espaçamento do reentro, use a IndentSize propriedade. Pode especificar se deve esvaziar automaticamente o buffer de saída após cada escrita, definindo a AutoFlush propriedade para true.

Para .NET aplicações Framework, podes definir o AutoFlush e IndentSize para Debug editando o ficheiro de configuração da tua aplicação. O ficheiro de configuração deve ser formatado conforme mostrado no exemplo seguinte.

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

O ConditionalAttribute atributo aplica-se aos métodos de Debug. Compiladores que suportam ConditionalAttribute ignorar chamadas a estes métodos, a menos que DEBUG esteja definido como um símbolo de compilação condicional. Consulte a documentação do compilador para determinar se ConditionalAttribute é suportado 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 /d:DEBUG opção à linha de comandos do compilador quando compilar o seu código usando uma linha de comandos, ou adicione #define DEBUG no topo do seu ficheiro. Em Visual Basic, adicione a opção /d:DEBUG=True à linha de comandos do compilador ou adicione #Const DEBUG=True ao ficheiro.

Segurança de Thread

Este tipo é seguro para fios.

Ver também

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