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 seguinte serve Trace para indicar o início e o fim da execução de um programa. O exemplo também utiliza os Trace.Indent métodos e Trace.Unindent para distinguir a saída do traço. Para um exemplo mais completo da utilização de Trace, veja Como: Adicionar Instruções de Rastreamento ao Código da Aplicação.

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

Observações

Podes usar as propriedades e métodos da Trace classe para lançar builds de instrumentos. Instrumentação permite-lhe monitorizar o estado da sua aplicação a correr em ambientes reais. O rastreamento ajuda-te a isolar problemas e resolvê-los sem perturbar o sistema em funcionamento.

Esta classe fornece métodos para mostrar uma Assert caixa de diálogo e emitir uma asserção que irá sempre Fail. 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. Nas 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 numa aplicação .NET Framework, consulte a classe Switch e Como: Criar, Inicializar e Configurar 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 saída do traço é emitida usando a DefaultTraceListener classe.

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

Nas aplicações .NET Framework, pode definir o AutoFlush e IndentSize para Trace editando o ficheiro de configuração correspondente ao nome da sua aplicação. O ficheiro de configuração deve ser formatado como o seguinte exemplo:

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

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

ConditionalAttribute não é suportado pelo compilador C++. Para fornecer funcionalidade equivalente, deve incluir chamadas aos métodos de Trace num #if defined(TRACE) ... #endif bloco e adicionar a /DTRACE opção à linha de comandos do compilador ou adicionar #define TRACE ao ficheiro.

Segurança de Thread

Este tipo é seguro para fios.

Ver também

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