Elemento <trace>

  • Artigo

Contém os ouvintes que coletam, armazenam e roteiam mensagens de rastreamento.

<configuração>
  <system.diagnostics>
    <trace>

Syntax

<trace autoflush="true|false"
       indentsize="indent value"  
       useGlobalLock="true| false"/>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
autoflush Atributo opcional.

Especifica se os ouvintes de rastreamento liberam automaticamente o buffer de saída após cada operação de gravação.
indentsize Atributo opcional.

Especifica o número de espaços a serem recuados.
useGlobalLock Atributo opcional.

Indica se deve ser usado um bloqueio global.

Atributo autoflush

Valor Descrição
false Não libera automaticamente o buffer de saída. Esse é o padrão.
true Libera automaticamente o buffer de saída.

Atributo useGlobalLock

Valor Descrição
false Não usa o bloqueio global se o ouvinte for thread-safe; caso contrário, usa o bloqueio global.
true Usa o bloqueio global independentemente de o ouvinte ser thread-safe. Esse é o padrão.

Elementos filho

Elemento Descrição
<listeners> Especifica um ouvinte que coleta, armazena e roteia mensagens.

Elementos pai

Elemento Descrição
configuration O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.
system.diagnostics Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que uma opção de rastreamento é definida.

Exemplo

O exemplo a seguir mostra como usar o elemento <trace> para adicionar o ouvinte MyListener à coleção Listeners. MyListener cria um arquivo que é nomeado MyListener.log e grava a saída no arquivo. O atributo useGlobalLock é definido como false, o que faz com que o bloqueio global não seja usado se o ouvinte de rastreamento for thread-safe. O atributo autoflush é definido como true, o que faz com que o ouvinte de rastreamento escreva no arquivo, independentemente de o método Trace.Flush ser chamado. O atributo indentsize é definido como 0 (zero), o que faz com que o ouvinte recue zero espaços quando o método Trace.Indent é chamado.

<configuration>  
   <system.diagnostics>  
      <trace useGlobalLock="false" autoflush="true" indentsize="0">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Confira também