<trace> Elemento

Artigo
08/01/2011

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

<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 automaticamente liberar o buffer de saída após cada operação de gravação.
indentsize	Atributo opcional. Especifica o número de espaços para recuar.
useGlobalLock	Atributo opcional. Indica se o bloqueio global deve ser usado.

autoflush

Atributo opcional.

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

indentsize

Atributo opcional.

Especifica o número de espaços para recuar.

useGlobalLock

Atributo opcional.

Indica se o bloqueio global deve ser usado.

autoflush atributo

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

useGlobalLock atributo

Valor	Descrição
false	Use o bloqueio global se o ouvinte é thread-safe; Caso contrário, usa o bloqueio global.
true	Usa o bloqueio global, independentemente do ouvinte é thread-safe. Este é o padrão.

Elementos filho

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

Elementos pai

Elemento	Descrição
configuration	O elemento raiz em cada arquivo de configuração usadas pelos common language runtime e .NET Framework aplicativos.
system.diagnostics	Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que um switch de rastreamento está definido.

Exemplo

O exemplo a seguir mostra como usar o <trace> elemento para adicionar o ouvinte MyListener para o Listeners coleção. MyListenercria um arquivo chamado MyListener.log e grava a saída no arquivo. O useGlobalLock atributo está definido como false, que faz com que o bloqueio global não deve ser usado se o ouvinte de rastreamento é segmento seguro. O autoflush atributo está definido como true, que faz com que o ouvinte de rastreamento gravar o arquivo, independentemente se a Trace.Flush método é chamado. O indentsize atributo está definido como 0 (zero), que faz com que o ouvinte recuar zero espaços quando a Trace.Indent método é 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>