Como: Criar e inicializar listeners de rastreamento

Artigo
08/25/2010

The Depurar and Rastreamento classes enviam mensagens para objetos chamados ouvintes que recebem e processam essas mensagens.Um desse ouvinte, a DefaultTraceListener, é automaticamente criado e inicializado durante o rastreamento ou depuração está habilitado; para obter mais informações, consulte Ouvintes de rastreamento.Se você desejar Rastreamento or Depurar saída para ser direcionado a qualquer fontes adicionais, você deve criar e inicializar listeners de rastreamento adicionais.

Os ouvintes que você criar devem refletir suas necessidades individuais.Por exemplo, convém um registro de texto de toda a saída de rastreamento.Nesse caso, você criaria um ouvinte que escrevi todas as saídas para um novo arquivo de texto quando habilitado.Por Outros lado, apenas convém exibir saída durante a execução do aplicativo.Nesse caso, você pode criar um ouvinte direcionado toda a saída para uma janela do console.The EventLogTraceListener pode direcionar a saída de rastreamento para um log de eventos e o TextWriterTraceListener pode gravar a saída de rastreamento em um fluxo.

Criar e inicializar o ouvinte de rastreamento

Declare seu ouvinte de rastreamento.Se o ouvinte específico que você está criando requer quaisquer outros objetos, declará-los também.O exemplo a seguir mostra como criar um ouvinte que grava em um arquivo de texto:

' Creates the text file that the trace listener will write to.
Dim myTraceLog As New System.IO.FileStream("C:\myTraceLog.txt", _
   IO.FileMode.OpenOrCreate)
' Creates the new trace listener
Dim myListener As New TextWriterTraceListener(myTraceLog)

// Creates the text file that the trace listener will write to.
System.IO.FileStream myTraceLog = new 
   System.IO.FileStream("C:\\myTraceLog.txt", 
   System.IO.FileMode.OpenOrCreate);
// Creates the new trace listener.
System.Diagnostics.TextWriterTraceListener myListener = 
   new System.Diagnostics.TextWriterTraceListener(myTraceLog);

Emitir saída de rastreamento.
- Se desejar que o ouvinte para receber toda a saída de rastreamento, adicionar o ouvinte de rastreamento à Ouvintes coleção.
  
  O exemplo a seguir mostra como adicionar o ouvinte para o Ouvintes coleção:
```
Trace.Listeners.Add(myListener)
```
```
System.Diagnostics.Trace.Listeners.Add(myListener);
```
  - ou -
- Se não desejar que o ouvinte para receber saída de rastreamento, não o adicione à Ouvintes coleção.Você pode emitir saída por meio de um ouvinte independente do Ouvintes coleção chamando o próprio o ouvinte métodos de saída.O exemplo a seguir mostra como escrever uma linha para um ouvinte que não seja o Ouvintes coleção:
```
myListener.WriteLine( _
   "This output will not go to the Listeners collection")
```
```
myListener.WriteLine( 
   "This output will not go to the Listeners collection");
```

Se o ouvinte não for um membro do Ouvintes coleção, talvez seja necessário chamar o Liberar método para registrar sua saída.

' Flushes the buffers of all listeners in the Listeners collection.
Trace.Flush()
' Flushes only the buffer of myListener.
myListener.Flush()

// Flushes the buffers of all listeners in the Listeners collection.
System.Diagnostics.Trace.Flush();
// Flushes only the buffer of myListener.
myListener.Flush();

Consulte também

Compartilhar via

Como: Criar e inicializar listeners de rastreamento

Criar e inicializar o ouvinte de rastreamento

Consulte também

Tarefas

Conceitos

Outros recursos

Recursos adicionais