DelimitedListTraceListener Classe

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TextWriterTraceListener.dll

Origem:

DelimitedListTraceListener.cs

Direciona a saída de rastreamento ou depuração para um gravador de texto, como um gravador de fluxo ou para um fluxo, como um fluxo de arquivos.

public ref class DelimitedListTraceListener : System::Diagnostics::TextWriterTraceListener

public class DelimitedListTraceListener : System.Diagnostics.TextWriterTraceListener

type DelimitedListTraceListener = class
    inherit TextWriterTraceListener

Public Class DelimitedListTraceListener
Inherits TextWriterTraceListener

Herança

Object

MarshalByRefObject

TraceListener

TextWriterTraceListener

DelimitedListTraceListener

Comentários

A saída de rastreamento está em um formato de texto delimitado que usa o delimitador especificado pela propriedade Delimiter. O delimitador é usado para encerrar cada campo em uma linha de saída. Por exemplo, para exibir a saída de rastreamento em uma planilha do Microsoft Excel, você pode especificar uma vírgula (",") como um delimitador e criar um arquivo CSV (valor separado por vírgulas).

Importante

Esse tipo implementa a interface IDisposable. Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente. Para descartar o tipo diretamente, chame seu Dispose método em umtry/catch bloco. Para descartá-lo indiretamente, use um constructo de linguagem como using ( em C#) ou Using (em Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.

Você pode criar um DelimitedListTraceListener em seu código. Como alternativa, somente em aplicativos .NET Framework, você pode habilitar ou desabilitar um DelimitedListTraceListener por meio do arquivo de configuração do aplicativo e, em seguida, usar o configurado DelimitedListTraceListener em seu aplicativo.

Observação

O DelimitedListTraceListener delimita apenas o texto emitido usando os métodos que têm nomes começando com a palavra Trace, como DelimitedListTraceListener.TraceEvent ou Trace.TraceWarning. Os dados de rastreamento emitidos usando os Debug.Write métodos e TextWriterTraceListener.WriteLine não são delimitados.

Para configurar um DelimitedListTraceListener em um aplicativo .NET Framework, edite o arquivo de configuração que corresponde ao nome do aplicativo. Nesse arquivo, você pode adicionar um ouvinte, definir as propriedades de um ouvinte ou remover um ouvinte. O arquivo de configuração deve ser formatado conforme mostrado no exemplo a seguir:

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="delimitedListener"   
          type="System.Diagnostics.DelimitedListTraceListener"   
          delimiter=","   
          initializeData="delimitedOutput.csv"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Observação

Se você tentar gravar em um arquivo que esteja em uso ou indisponível, o nome do arquivo será automaticamente prefixado por um GUID.

Observação

Os ouvintes devem ser usados por métodos das Debugclasses , Tracee TraceSource para gravar informações de rastreamento. Os métodos de ouvinte, exceto os construtores, não devem ser chamados diretamente do código do aplicativo.

Construtores

DelimitedListTraceListener(Stream)	Inicializa uma nova instância da classe DelimitedListTraceListener que é gravada no fluxo de saída especificado.
DelimitedListTraceListener(Stream, String)	Inicializa uma nova instância da classe DelimitedListTraceListener que é gravada no fluxo de saída especificado e tem o nome indicado.
DelimitedListTraceListener(String)	Inicializa uma nova instância da classe DelimitedListTraceListener que é gravada para o arquivo especificado.
DelimitedListTraceListener(String, String)	Inicializa uma nova instância da classe DelimitedListTraceListener que grava no arquivo especificado e tem o nome indicado.
DelimitedListTraceListener(TextWriter)	Inicializa uma nova instância da classe DelimitedListTraceListener que é gravada para o text writer especificado.
DelimitedListTraceListener(TextWriter, String)	Inicializa uma nova instância da classe DelimitedListTraceListener que é gravada no text writer especificado e tem o nome indicado.

Propriedades

Attributes	Obtém os atributos do ouvinte de rastreamento personalizados definidos no arquivo de configuração de aplicativo. (Herdado de TraceListener)
Delimiter	Obtém ou define o delimitador para a lista delimitada.
Filter	Obtém ou define o filtro de rastreamento para o ouvinte de rastreamento. (Herdado de TraceListener)
IndentLevel	Obtém ou define o nível de recuo. (Herdado de TraceListener)
IndentSize	Obtém ou define o número de espaços em um recuo. (Herdado de TraceListener)
IsThreadSafe	Obtém um valor que indica se o ouvinte de rastreamento é thread-safe. (Herdado de TraceListener)
Name	Obtém ou define um nome para este TraceListener. (Herdado de TraceListener)
NeedIndent	Obtém ou define um valor que indica se a saída deve ser recuada. (Herdado de TraceListener)
TraceOutputOptions	Obtém ou define as opções de saída de rastreamento. (Herdado de TraceListener)
Writer	Obtém ou define o text writer que recebe a saída do rastreamento ou da depuração. (Herdado de TextWriterTraceListener)

Métodos

Close()	Fecha o Writer para que ele não receba mais a saída de rastreamento ou de depuração. (Herdado de TextWriterTraceListener)
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo TraceListener. (Herdado de TraceListener)
Dispose(Boolean)	Descarta este objeto TextWriterTraceListener. (Herdado de TextWriterTraceListener)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Fail(String)	Emite uma mensagem de erro para o ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Fail(String, String)	Emite uma mensagem de erro e uma mensagem de erro detalhada para o ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Flush()	Libera o buffer de saída para o Writer. (Herdado de TextWriterTraceListener)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetSupportedAttributes()	Retorna o atributo de arquivo de configuração personalizado compatível com o ouvinte de rastreamento delimitado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Grava as informações de rastreamento, um objeto de dados e informações de evento no fluxo ou arquivo de saída.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Grava as informações de rastreamento, uma matriz de objetos de dados e informações de evento no fluxo ou arquivo de saída.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Grava as informações de rastreamento e evento para a saída específica do ouvinte. (Herdado de TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Grava as informações de rastreamento, uma mensagem e informações de evento no fluxo ou arquivo de saída.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Grava informações de rastreamento, uma matriz de objetos formatada e informações de evento no fluxo ou arquivo de saída.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Grava informações de rastreamento, uma mensagem, uma identidade de atividade relacionada e informações de evento na saída específica do ouvinte. (Herdado de TraceListener)
Write(Object)	Grava o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Write(Object, String)	Grava um nome de categoria e o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
Write(String)	Grava uma mensagem no Writer desta instância. (Herdado de TextWriterTraceListener)
Write(String, String)	Grava um nome de categoria e uma mensagem no ouvinte criado ao implementar a classe TraceListener. (Herdado de TraceListener)
WriteIndent()	Grava o recuo para o ouvinte criar durante a implementação dessa classe e redefine a propriedade NeedIndent para false. (Herdado de TraceListener)
WriteLine(Object)	Grava o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha. (Herdado de TraceListener)
WriteLine(Object, String)	Grava um nome de categoria e o valor do método ToString() do objeto no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha. (Herdado de TraceListener)
WriteLine(String)	Grava uma mensagem no Writer desta instância seguido por um terminador de linha. O terminador de linha padrão é um retorno de carro seguido por uma alimentação de linha (\r\n). (Herdado de TextWriterTraceListener)
WriteLine(String, String)	Grava um nome de categoria e uma mensagem no ouvinte criado ao implementar a classe TraceListener, seguido por um terminador de linha. (Herdado de TraceListener)