Partilhar via

<trace> Elemento

Contém ouvintes que recolhem, armazenam e encaminham mensagens de rastreio.

<Configuração><System.Diagnostics><Trace>

Sintaxe

<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.

Attributes

Attribute Description
autoflush Atributo opcional.

Especifica se os ouvintes de traços limpam automaticamente o buffer de saída após cada operação de escrita.
indentsize Atributo opcional.

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

Indica se o bloqueio global deve ser usado.

autoflush Atributo

Valor Description
false Não limpa automaticamente o buffer de saída. Este é o padrão.
true Limpa automaticamente o buffer de saída.

Atributo useGlobalLock

Valor Description
false Não usa o bloqueio global se o ouvinte for seguro para threads; caso contrário, usa o bloqueio global.
true Usa o bloqueio global independentemente de o ouvinte ser seguro para threads. Este é o padrão.

Elementos Subordinados

Elemento Description
<ouvintes> Especifica um ouvinte que recolhe, armazena e encaminha mensagens.

Elementos Principais

Elemento Description
configuration O elemento raiz em cada arquivo de configuração usado pelo Common Language Runtime e aplicativos .NET Framework.
system.diagnostics Especifica ouvintes de rastreio que recolhem, armazenam e encaminham mensagens e o nível onde um comutador de traço está definido.

Example

O exemplo seguinte mostra como usar o <trace> elemento para adicionar o ouvinte MyListener à Listeners coleção. MyListener cria um ficheiro com nome MyListener.log e grava a saída no ficheiro. O useGlobalLock atributo é definido para false, o que faz com que o bloqueio global não seja usado se o ouvinte de traços for seguro para threads. O autoflush atributo é definido como true, o que faz com que o ouvinte de traços escreva no ficheiro independentemente de o Trace.Flush método ser chamado ou não. O indentsize atributo é definido para 0 (zero), o que faz com que o ouvinte indente espaços zero quando o 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>

Consulte também

  • Last updated on