Compartilhar via

<trace> Elemento

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

<rastreamento de system.diagnostics de configuração><><>

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 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 recuos.
useGlobalLock Atributo opcional.

Indica se o bloqueio global deve ser usado.

Atributo autoflush

Value Description
false Não libera automaticamente o buffer de saída. Esse é o padrão.
true Libera automaticamente o buffer de saída.

Atributo useGlobalLock

Value Description
false Não usará o bloqueio global se o ouvinte estiver seguro em thread; 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 Description
<Ouvintes> Especifica um ouvinte que coleta, armazena e roteia mensagens.

Elementos pai

Elemento Description
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 um comutador de rastreamento é definido.

Example

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