Trace Classe

Definição

public ref class Trace sealed

public sealed class Trace

type Trace = class

Public NotInheritable Class Trace

Herança

Object

Trace

Exemplos

O exemplo a seguir usa Trace para indicar o início e o fim da execução de um programa. O exemplo também usa os métodos e Trace.Unindent para Trace.Indent distinguir a saída de rastreamento. Para obter um exemplo mais completo do uso de, consulte Como adicionar instruções de rastreamento ao código do Traceaplicativo.

// Specify /d:TRACE when compiling.

using System;
using System.Diagnostics;

class Test
{
    static void Main()
    {
       Trace.Listeners.Add(new TextWriterTraceListener(Console.Out));
       Trace.AutoFlush = true;
       Trace.Indent();
       Trace.WriteLine("Entering Main");
       Console.WriteLine("Hello World.");
       Trace.WriteLine("Exiting Main");
       Trace.Unindent();
    }
}

' Specify /d:TRACE=True when compiling.

Imports System.Diagnostics

Class Test
    
    Shared Sub Main()
    
        Trace.Listeners.Add(New TextWriterTraceListener(Console.Out))
        Trace.AutoFlush = True
        Trace.Indent()
        Trace.WriteLine("Entering Main")
        Console.WriteLine("Hello World.")
        Trace.WriteLine("Exiting Main")
        Trace.Unindent()
        
    End Sub

End Class

Comentários

Você pode usar as propriedades e os métodos na Trace classe para instrumentar builds de versão. A instrumentação permite monitorar a integridade do aplicativo em execução nas configurações da vida real. O rastreamento ajuda você a isolar problemas e corrigi-los sem perturbar um sistema em execução.

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

• Write
• WriteLine
• WriteIf
• WriteLineIf

O BooleanSwitch e TraceSwitch as classes fornecem meios para controlar dinamicamente a saída de rastreamento. Em aplicativos .NET Framework, você pode modificar os valores dessas opções sem recompilar seu aplicativo. Para obter informações sobre como usar o arquivo de configuração para definir uma opção em um aplicativo .NET Framework, consulte a classe Switch e How to: Create, Initialize e Configure Trace Switches.

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 pelas classes; adicionar um ouvinte de rastreamento a qualquer classe adiciona o ouvinte a ambos. Por padrão, a saída de rastreamento é emitida usando a DefaultTraceListener classe.

A Trace classe fornece propriedades para obter ou definir o nível de Indent e o IndentSize, e se deseja AutoFlush após cada gravação.

Em aplicativos .NET Framework, você pode definir o AutoFlush e IndentSize para Trace editando o arquivo de configuração que corresponde ao nome do aplicativo. O arquivo de configuração deve ser formatado como o exemplo a seguir:

<configuration>
  <system.diagnostics>
    <trace autoflush="false" indentsize="3" />
  </system.diagnostics>
</configuration>

O ConditionalAttribute atributo é aplicado aos métodos de Trace. Compiladores que dão suporte ConditionalAttribute a ignorar chamadas a esses métodos TRACE , 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 TRACE símbolo de compilação condicional em C#, adicione a opção /d:TRACE à linha de comando do compilador ao compilar seu código usando uma linha de comando ou adicione #define TRACE à parte superior do arquivo. No Visual Basic, adicione a opção /d:TRACE=True à linha de comando do compilador ou adicione #Const TRACE=True ao arquivo.

ConditionalAttribute não há suporte para o compilador C++. Para fornecer funcionalidade equivalente, você deve colocar chamadas entre os métodos de Trace um #if defined(TRACE) ... #endif bloco e adicionar a opção /DTRACE à linha de comando do compilador ou adicionar #define TRACE ao arquivo.

Acesso thread-safe

Esse tipo é thread safe.

Confira também

• Debug
• Switch
• BooleanSwitch
• TraceSwitch
• TraceListener
• DefaultTraceListener
• EventLogTraceListener
• TraceListenerCollection
• ConditionalAttribute