TraceListener Classe

Definição

Namespace:
System.Diagnostics
Assembly:
System.dll
Assembly:
netstandard.dll

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

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

Comentários

Para obter exemplos de como implementar umTraceListener, consulte o DefaultTraceListenerTextWriterTraceListener e as EventLogTraceListener classes.

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 seu 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 seu 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 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.diagnostics>.

Notas aos Implementadores

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

Construtores

Nome Description
TraceListener()

Inicializa uma nova instância da classe TraceListener.
TraceListener(String)

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

Propriedades

Nome Description
Attributes

Obtém os atributos do ouvinte de rastreamento personalizado definidos no arquivo de configuração do 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 isso TraceListener.
NeedIndent

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

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

Métodos

Nome Description
Close()

Quando substituído em uma classe derivada, fecha o fluxo de saída para que ele não receba mais a saída 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, String)

Emite uma mensagem de erro e uma mensagem de erro detalhada para o ouvinte que você cria ao implementar a TraceListener classe.
Fail(String)

Emite uma mensagem de erro para o ouvinte que você cria ao implementar a TraceListener classe.
Flush()

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

Serve como a função hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de tempo de vida para essa instância.

(Herdado de MarshalByRefObject)
GetSupportedAttributes()

Obtém os atributos personalizados compatíveis com o ouvinte de rastreamento.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida dessa instância.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Grava informações de rastreamento, um objeto de dados e informações de evento na 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 para a saída específica do ouvinte.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Grava informações de rastreamento, uma matriz formatada de objetos e informações de 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)

Grava informações de rastreamento e 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 para a saída específica do ouvinte.
Write(Object, String)

Grava um nome de categoria e o valor do método do ToString() objeto no ouvinte que você cria ao implementar a TraceListener classe.
Write(Object)

Grava o valor do método do ToString() objeto no ouvinte que você cria ao implementar a TraceListener classe.
Write(String, String)

Grava um nome de categoria e uma mensagem no ouvinte que você cria ao implementar a TraceListener classe.
Write(String)

Quando substituído em uma classe derivada, grava a mensagem especificada no ouvinte que você cria na classe derivada.
WriteIndent()

Grava o recuo no ouvinte que você cria ao implementar essa classe e redefine a NeedIndent propriedade para false.
WriteLine(Object, String)

Grava um nome de categoria e o valor do método do ToString() objeto no ouvinte que você cria quando implementa a TraceListener classe, seguido por um terminador de linha.
WriteLine(Object)

Grava o valor do método do ToString() objeto no ouvinte que você cria quando implementa a TraceListener classe, seguido por um terminador de linha.
WriteLine(String, String)

Grava um nome de categoria e uma mensagem para o ouvinte que você cria ao implementar a TraceListener classe, seguido por um terminador de linha.
WriteLine(String)

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

Aplica-se a

Acesso thread-safe

Esse tipo é thread safe.

Confira também