<system.diagnostics> Elemento

Artigo
08/01/2011

Especifica os ouvintes de rastreamento que coletam, armazenam e roteiam mensagens e o nível em que um switch de rastreamento está definido.

<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 deve exibir uma caixa de mensagem quando você chamar o Debug.Assert método; também especifica o nome do arquivo para gravar as mensagens.
<performanceCounters>	Especifica o tamanho da memória global compartilhado por contadores de desempenho.
<sharedListeners>	Contém os ouvintes que qualquer elemento de rastreamento ou de origem fazem referência. Ouvintes identificados como ouvintes compartilhados podem ser adicionados para fontes ou em rastreamentos pelo nome.
<sources>	Especifica as fontes de rastreamento que iniciam mensagens de rastreamento.
<switches>	Contém opções de rastreamento e os níveis de onde 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 usadas pelos common language runtime e .NET Framework aplicativos.

Exemplo

O exemplo a seguir mostra como incorporar um switch de rastreamento e dentro de um ouvinte de rastreamento de <system.diagnostics> elemento. O General a opção de rastreamento é definida como o TraceLevel.Error nível. 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 um switch.Por exemplo, você pode especificar true para um BooleanSwitch ou use 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>

Consulte também

Referência

Rastreamento e esquema configurações Debug

Trace

Debug

Share via