<system.diagnostics> Element

Artigo
04/08/2023

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.

<configuração>
<system.diagnostics>

Syntax

<system.diagnostics>
</system.diagnostics>

Atributos e Elementos

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

Atributos

Nenhum.

Elementos Subordinados

Elemento	Descrição
<afirmar>	Especifica se pretende apresentar uma caixa de mensagem quando chama o Debug.Assert método; também especifica o nome do ficheiro para o qual escrever mensagens.
<performanceCounters>	Especifica o tamanho da memória global partilhada pelos contadores de desempenho.
<sharedListeners>	Contém serviços de escuta que qualquer elemento de origem ou rastreio pode referenciar. Os serviços de escuta identificados como serviços de escuta partilhados podem ser adicionados a origens ou rastreios por nome.
<origens>	Especifica origens de rastreio que iniciam mensagens de rastreio.
<comutadores>	Contém comutadores de rastreio e os níveis onde os comutadores de rastreio estão definidos.
<rastreio>	Contém serviços de escuta que recolhem, armazenam e encaminham mensagens de rastreio.

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.

Exemplo

O exemplo seguinte mostra como incorporar um comutador de rastreio e um serviço de escuta de rastreio dentro do <elemento system.diagnostics> . O General comutador de rastreio está definido para o TraceLevel nível. O serviço de escuta myListener de rastreio cria um ficheiro chamado MyListener.log e escreve o resultado no ficheiro.

Nota

No .NET Framework versão 2.0, pode utilizar texto para especificar o valor de um comutador. Por exemplo, pode especificar true para um BooleanSwitch ou utilizar o texto que representa um valor de enumeração, como Error para um TraceSwitch. A linha <add name="myTraceSwitch" value="Error" /> é equivalente a <add name="myTraceSwitch" value="1" />.

<configuration>  
   <system.diagnostics>  
      <switches>  
         <add name="General" value="4" />  
      </switches>  
      <trace autoflush="true" indentsize="2">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, System, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="MyListener.log" traceOutputOptions="ProcessId, LogicalOperationStack, Timestamp, ThreadId, Callstack, DateTime" />  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>

Partilhar via