Partilhar via


TraceListener Classe

Definição

Fornece a classe base abstract para os ouvintes que monitoram o rastreamento e a saída da depuração.

public ref class TraceListener abstract : MarshalByRefObject, IDisposable
public ref class TraceListener abstract : IDisposable
public abstract class TraceListener : MarshalByRefObject, IDisposable
public abstract class TraceListener : IDisposable
type TraceListener = class
    inherit MarshalByRefObject
    interface IDisposable
type TraceListener = class
    interface IDisposable
Public MustInherit Class TraceListener
Inherits MarshalByRefObject
Implements IDisposable
Public MustInherit Class TraceListener
Implements IDisposable
Herança
TraceListener
Herança
TraceListener
Derivado
Implementações

Comentários

Para obter exemplos de como implementar um TraceListener, consulte as DefaultTraceListenerclasses e TextWriterTraceListenerEventLogTraceListener .

Você deve habilitar o rastreamento ou a depuração para usar um ouvinte de rastreamento. A sintaxe a seguir é específica do compilador. Se você usar compiladores diferentes de C# ou Visual Basic, consulte a documentação do compilador.

  • Para habilitar a depuração em C#, adicione o /d:DEBUG sinalizador à linha de comando do compilador ao compilar o código ou adicione #define DEBUG à parte superior do arquivo. No Visual Basic, adicione o /d:DEBUG=True sinalizador à linha de comando do compilador.

  • Para habilitar o rastreamento em C#, adicione o /d:TRACE sinalizador à linha de comando do compilador ao compilar o código ou adicione #define TRACE à parte superior do arquivo. No Visual Basic, adicione o /d:TRACE=True sinalizador à linha de comando do compilador.

Para adicionar um ouvinte de rastreamento, edite o arquivo de configuração que corresponde ao nome do aplicativo. Nesse arquivo, você pode adicionar um ouvinte, definir seu tipo e definir seu parâmetro, remover um ouvinte ou limpar todos os ouvintes definidos anteriormente pelo aplicativo. O arquivo de configuração deve ser formatado de forma semelhante ao exemplo a seguir.

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

Para obter mais informações sobre como usar arquivos de configuração para rastreamento, consulte <system.diagnóstico>.

Notas aos Implementadores

Herde dessa classe para implementar um ouvinte personalizado para as Debug classes e Trace . No mínimo, você deve implementar os Write(String) métodos e WriteLine(String) . Além disso, você pode implementar os Fail(String)métodos e Close()Flush() .

Construtores

TraceListener()

Inicializa uma nova instância da classe TraceListener.

TraceListener(String)

Inicializa uma nova instância da classe TraceListener usando o nome especificado como ouvinte.

Propriedades

Attributes

Obtém os atributos do ouvinte de rastreamento personalizados definidos no arquivo de configuração de aplicativo.

Filter

Obtém ou define o filtro de rastreamento para o ouvinte de rastreamento.

IndentLevel

Obtém ou define o nível de recuo.

IndentSize

Obtém ou define o número de espaços em um recuo.

IsThreadSafe

Obtém um valor que indica se o ouvinte de rastreamento é thread-safe.

Name

Obtém ou define um nome para este TraceListener.

NeedIndent

Obtém ou define um valor que indica se a saída deve ser recuada.

TraceOutputOptions

Obtém ou define as opções de saída de rastreamento.

Métodos

Close()

Quando substituído em uma classe derivada, fecha o fluxo de saída para que ele não receba mais saídas de rastreamento ou depuração.

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.

Dispose(Boolean)

Libera os recursos não gerenciados usados pelo TraceListener e opcionalmente libera os recursos gerenciados.

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.

Fail(String, String)

Emite uma mensagem de erro e uma mensagem de erro detalhada para o ouvinte criado ao implementar a classe TraceListener.

Flush()

Quando substituído em uma classe derivada, libera o buffer de saída.

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()

Obtém os atributos personalizados com suporte no ouvinte de rastreamento.

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 para a saída específica do ouvinte.

TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Grava informações de rastreamento, uma matriz de objetos de dados e informações de evento na saída específica do ouvinte.

TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Grava as informações de rastreamento e evento para a saída específica do ouvinte.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Grava informações de rastreamento, uma mensagem e informações de evento na saída específica do ouvinte.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Grava informações de rastreamento, uma matriz de objetos formatada e informações de evento na saída específica do ouvinte.

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.

Write(Object)

Grava o valor do método ToString() do objeto no ouvinte criado ao implementar a classe 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.

Write(String)

Quando substituído em uma classe derivada, grava a mensagem especificada no ouvinte criado na classe derivada.

Write(String, String)

Grava um nome de categoria e uma mensagem no ouvinte criado ao implementar a classe TraceListener.

WriteIndent()

Grava o recuo para o ouvinte criar durante a implementação dessa classe e redefine a propriedade NeedIndent para false.

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.

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.

WriteLine(String)

Quando substituído em uma classe derivada, grava uma mensagem no ouvinte criado na classe derivada, seguida por um terminador de linha.

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.

Aplica-se a

Acesso thread-safe

Este tipo é thread-safe.

Confira também