TraceListener Classe

Definição

Espaço de Nomes:
System.Diagnostics
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Fornece a abstract classe base para os ouvintes que monitorizam a saída de rastreio 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

Observações

Para exemplos de como implementar um TraceListener, veja as DefaultTraceListener, TextWriterTraceListener e as EventLogTraceListener classes.

Deve ativar o rastreio ou depuração para usar um ouvinte de rastreamento. A sintaxe seguinte é específica do compilador. Se usar compiladores que não sejam C# ou Visual Basic, consulte a documentação do seu compilador.

  • Para permitir a depuração em C#, adicione a /d:DEBUG flag à linha de comandos do compilador quando compilar o seu código, ou pode adicionar #define DEBUG no topo do seu ficheiro. Em Visual Basic, adicione a flag /d:DEBUG=True à linha de comandos do compilador.

  • Para ativar o traçado em C#, adicione a /d:TRACE flag à linha de comandos do compilador quando compilar o seu código, ou adicione #define TRACE no topo do seu ficheiro. Em Visual Basic, adicione a flag /d:TRACE=True à linha de comandos do compilador.

Para adicionar um ouvinte de traços, edite o ficheiro de configuração correspondente ao nome da sua aplicação. Dentro deste ficheiro, pode adicionar um ouvinte, definir o seu tipo e definir o seu parâmetro, remover um ouvinte ou limpar todos os ouvintes previamente definidos pela aplicação. O ficheiro de configuração deve ser formatado de forma semelhante ao seguinte exemplo.

<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 mais informações sobre o uso de ficheiros de configuração para rastreamento, consulte <system.diagnostics>.

Notas para Implementadores

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

Construtores

Name Description
TraceListener()

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

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

Propriedades

Name Description
Attributes

Obtém os atributos personalizados do ouvinte de rastreio definidos no ficheiro de configuração da aplicação.
Filter

Obtém ou define o filtro de traço para o ouvinte de traços.
IndentLevel

Obtém ou define o nível da recuação.
IndentSize

Obtém ou define o número de espaços num reentro.
IsThreadSafe

Recebe um valor que indica se o ouvinte de rastreio é seguro para threads.
Name

Obtém ou define um nome para este TraceListener.
NeedIndent

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

Obtém ou define as opções de saída do traço.

Métodos

Name Description
Close()

Quando é sobreposto numa classe derivada, fecha o fluxo de saída para que já não receba saída de traçado ou depuração.
CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Liberta todos os recursos utilizados pelo TraceListener.
Dispose(Boolean)

Liberta os recursos não geridos usados pelo TraceListener e opcionalmente liberta os recursos geridos.
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 crias quando implementas a TraceListener classe.
Fail(String)

Emite uma mensagem de erro para o ouvinte que crias quando implementas a TraceListener classe.
Flush()

Quando sobreposto numa classe derivada, limpa o buffer de saída.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetSupportedAttributes()

Obtém os atributos personalizados suportados pelo ouvinte de rastreamento.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
ToString()

Devolve uma cadeia que representa o objeto atual.

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

Escreve informação de traço, um objeto de dados e informações de eventos para a saída específica do ouvinte.
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Escreve informação de rastreio, um array de objetos de dados e informação de eventos para a saída específica do ouvinte.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Escreve informação de rastreio, um array formatado de objetos e informações de eventos para a saída específica do ouvinte.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Escreve informação de rastreio, uma mensagem e informações de eventos para a saída específica do ouvinte.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Escreve informações de rastreio e evento para a saída específica do ouvinte.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Escreve informação de rastreio, uma mensagem, uma identidade de atividade relacionada e informações de eventos para a saída específica do ouvinte.
Write(Object, String)

Escreve um nome de categoria e o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe.
Write(Object)

Escreve o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe.
Write(String, String)

Escreve um nome de categoria e uma mensagem para o ouvinte que crias quando implementas a TraceListener classe.
Write(String)

Quando sobreposta numa classe derivada, escreve a mensagem especificada para o ouvinte que cria na classe derivada.
WriteIndent()

Escreve o indentamento para o ouvinte que crias quando implementas esta classe, e redefine a NeedIndent propriedade para false.
WriteLine(Object, String)

Escreve um nome de categoria e o valor do método do objeto ToString() para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha.
WriteLine(Object)

Escreve o valor do método do ToString() objeto para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha.
WriteLine(String, String)

Escreve um nome de categoria e uma mensagem para o ouvinte que crias quando implementas a TraceListener classe, seguido de um terminador de linha.
WriteLine(String)

Quando sobrescrito numa classe derivada, escreve uma mensagem para o ouvinte que cria na classe derivada, seguida de um terminador de linha.

Aplica-se a

Segurança de Thread

Este tipo é seguro para fios.

Ver também