<elemento trace>

Artigo
04/08/2023

Contém serviços de escuta que recolhem, armazenam e encaminham mensagens de rastreio.

<configuração>
<system.diagnostics>
<rastreio>

Syntax

<trace autoflush="true|false"
       indentsize="indent value"  
       useGlobalLock="true| false"/>

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
`autoflush`	Atributo opcional. Especifica se os serviços de escuta de rastreio limpam automaticamente a memória intermédia de saída após cada operação de escrita.
`indentsize`	Atributo opcional. Especifica o número de espaços a avançar.
`useGlobalLock`	Atributo opcional. Indica se o bloqueio global deve ser utilizado.

Atributo autoflush

Valor	Descrição
`false`	Não limpa automaticamente a memória intermédia de saída. Esta é a predefinição.
`true`	Limpa automaticamente a memória intermédia de saída.

utilizar AtributoGlobalLock

Valor	Descrição
`false`	Não utiliza o bloqueio global se o serviço de escuta for seguro para threads; caso contrário, utiliza o bloqueio global.
`true`	Utiliza o bloqueio global, independentemente de o serviço de escuta ser seguro para threads. Esta é a predefinição.

Elementos Subordinados

Elemento	Descrição
<serviços de escuta>	Especifica um serviço de escuta que recolhe, armazena e encaminha mensagens.

Elementos Principais

Elemento	Descrição
`configuration`	O elemento raiz em todos os ficheiros de configuração utilizados pelo runtime de idioma comum e .NET Framework aplicações.
`system.diagnostics`	Especifica serviços de escuta de rastreio que recolhem, armazenam e encaminham mensagens e o nível em que um comutador de rastreio está definido.

Exemplo

O exemplo seguinte mostra como utilizar o <trace> elemento para adicionar o serviço de MyListener escuta à Listeners coleção. MyListener cria um ficheiro com o nome MyListener.log e escreve o resultado no ficheiro. O useGlobalLock atributo está definido como false, o que faz com que o bloqueio global não seja utilizado se o serviço de escuta de rastreio for seguro para threads. O autoflush atributo está definido como true, o que faz com que o serviço de escuta de rastreio escreva no ficheiro, independentemente de o Trace.Flush método ser chamado. O indentsize atributo está definido como 0 (zero), o que faz com que o serviço de escuta avance para 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>

Partilhar via