Elemento <trace>

Artigo
08/25/2010

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

<configuration> Element
elemento <sistema.Diagnóstico>
Elemento <trace>

<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 gravar.
indentsize	Atributo opcional. Especifica o número de espaços para recuar.
useGlobalLock	Atributo opcional. Indica se o bloquear 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 gravar.

indentsize

Atributo opcional.

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

useGlobalLock

Atributo opcional.

Indica se o bloquear global deve ser usado.

Atributo autoflush

Valor	Descrição
false	Não limpa automaticamente o buffer de saída. Este é o padrão.
true	Liberações do buffer de saída automaticamente.

Atributo useGlobalLock

Valor	Descrição
false	Não usa o modelo global bloquear se o ouvinte é thread-safe; caso contrário, utiliza o bloquear global.
true	Usa o bloquear global, independentemente do ouvinte é thread-safe. Este é o padrão.

Elementos filho

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

Elementos pai

Elemento	Descrição
configuration	O elemento raiz em cada arquivo de configuração usado pelo Common linguagem tempo de execução e aplicativos do .NET estrutura.
system.diagnostics	Especifica os ouvintes de rastreamento que coletar, armazenar, e rota mensagens e o nível em que um comutador 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. MyListener cria um arquivo chamado MyListener.log e grava a saída para o arquivo. The useGlobalLock o atributo é conjunto para false, que faz com que o bloquear global não deve ser usado se o ouvinte de rastreamento é thread-safe. The autoflush o atributo é conjunto para true, que faz com que o ouvinte de rastreamento gravar o arquivo independentemente se a Trace.Flush método é chamado. The indentsize atributo é 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>