Como: Criar e inicializar Listeners de rastreamento

O System.Diagnostics.Debug e System.Diagnostics.Trace classes enviam mensagens para objetos chamados ouvintes que receber e processam essas mensagens. Um ouvinte, o System.Diagnostics.DefaultTraceListener, é criado e inicializado automaticamente quando o rastreamento ou depuração está habilitado. Se você quiser Trace ou Debug a saída para ser direcionado a qualquer fontes adicionais, você deve criar e inicializar listeners de rastreamento adicional.

Os ouvintes que você criar devem refletir as necessidades do seu aplicativo. Por exemplo, se desejar que um registro de texto de toda a saída de rastreamento, criar um TextWriterTraceListener ouvinte, que grava todas as saídas para um novo arquivo de texto quando ele estiver ativado. Por outro lado, se você desejar exibir a saída somente durante a execução do aplicativo, criar um ConsoleTraceListener ouvinte, que direciona todas as saídas para uma janela do console. O EventLogTraceListener pode direcionar a saída de rastreamento para um log de eventos. Para obter mais informações, consulte Ouvintes de rastreamento.

Você pode criar ouvintes de rastreamento em um arquivo de configuração do aplicativo ou em seu código. Recomendamos o uso de arquivos de configuração do aplicativo, porque eles permitem que você adicionar, modificar ou remover ouvintes de rastreamento sem alterar seu código.

Para criar e usar um ouvinte de rastreamento usando um arquivo de configuração

1. Declare seu ouvinte de rastreamento em seu arquivo de configuração do aplicativo. Se o ouvinte que você está criando requer que todos os outros objetos, declará-los também. O exemplo a seguir mostra como criar um ouvinte chamado myListener que grava no arquivo de texto TextWriterOutput.log.

   <configuration>
     <system.diagnostics>
       <trace autoflush="false" indentsize="4">
         <listeners>
           <add name="myListener" type="System.Diagnostics.TextWriterTraceListener" initializeData="TextWriterOutput.log" />
           <remove name="Default" />
         </listeners>
       </trace>
     </system.diagnostics>
   </configuration>
   

2. Use o Trace classe em seu código para gravar uma mensagem para os ouvintes de rastreamento.

   Trace.TraceInformation("Test message.")
   ' You must close or flush the trace to empty the output buffer.
   Trace.Flush()
   

   Trace.TraceInformation("Test message.");
   // You must close or flush the trace to empty the output buffer.
   Trace.Flush();
   

Para criar e usar um ouvinte de rastreamento no código

• Adicionar o ouvinte de rastreamento para o Listeners coleta e enviar informações de rastreamento de ouvintes.

  Trace.Listeners.Add(New TextWriterTraceListener("TextWriterOutput.log", "myListener"))
  Trace.TraceInformation("Test message.")
  ' You must close or flush the trace to empty the output buffer.
  Trace.Flush()
  

  Trace.Listeners.Add(new TextWriterTraceListener("TextWriterOutput.log", "myListener"));
  Trace.TraceInformation("Test message.");
  // You must close or flush the trace to empty the output buffer.
  Trace.Flush();
  

  - ou -

• Se você não quiser que seu ouvinte de saída de rastreamento exibida, não adicione-o para o Listeners coleção. Você pode emitir saída por meio de um ouvinte independente do Listeners a coleção, chamando métodos de saída. do ouvinte O exemplo a seguir mostra como gravar um ouvinte que não está em uma linha de Listeners coleção.

  Dim myListener As New TextWriterTraceListener("TextWriterOutput.log", "myListener")
  myListener.WriteLine("Test message.")
  ' You must close or flush the trace listener to empty the output buffer.
  myListener.Flush()
  

  TextWriterTraceListener myListener = new TextWriterTraceListener("TextWriterOutput.log", "myListener");
  myListener.WriteLine("Test message.");
  // You must close or flush the trace listener to empty the output buffer.
  myListener.Flush();
  

Consulte também

Tarefas

Como: Código de rastreamento em um aplicativo

Como: Adicionar instruções de rastreamento ao código do aplicativo

Conceitos

Ouvintes de rastreamento.

Opções de rastreamento.

Outros recursos

Rastreamento e intrumentando aplicações