Elemento <trace>

Artigo
05/09/2023

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>

Compartilhar via