Elemento <system.diagnostics>

Artigo
05/10/2023

Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que uma opção de rastreamento é definida.

<configuration>
<system.diagnostics>

Syntax

<system.diagnostics>
</system.diagnostics>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Nenhum.

Elementos filho

Elemento	Descrição
<assert>	Especifica se uma caixa de mensagem deve ser exibida ao chamar o método Debug.Assert; também especifica o nome do arquivo no qual as mensagens serão gravadas.
<performanceCounters>	Especifica o tamanho da memória global compartilhada por contadores de desempenho.
<sharedListeners>	Contém os ouvintes que podem ser referenciados por qualquer elemento de origem ou de rastreamento. Ouvintes identificados como ouvintes compartilhados podem ser adicionados a fontes ou rastreamentos por nome.
<sources>	Especifica origens de rastreamento que iniciam as mensagens de rastreamento.
<switches>	Contém opções de rastreamento e os níveis em que as opções de rastreamento são definidas.
<trace>	Contém os ouvintes que coletam, armazenam e roteiam mensagens de rastreamento.

Elementos pai

Elemento	Descrição
`configuration`	O elemento raiz em cada arquivo de configuração usado pelos aplicativos do Common Language Runtime e .NET Framework.

Exemplo

O exemplo a seguir mostra como inserir uma opção de rastreamento e um ouvinte de rastreamento no elemento <system.diagnostics>. A opção de rastreamento General é definida com o nível TraceLevel. O ouvinte de rastreamento myListener cria um arquivo chamado MyListener.log e grava a saída no arquivo.

Observação

No .NET Framework versão 2.0, você pode usar o texto para especificar o valor de uma opção. Por exemplo, true para uma BooleanSwitch, ou usar o texto que representa um valor de enumeração como Error para uma 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>

Compartilhar via