Elemento <system.diagnostics>

Articolo
08/11/2011

Specifica listener di traccia per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di analisi.

<system.diagnostics> 
</system.diagnostics>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
<assert>	Consente di specificare se deve essere visualizzata una finestra di messaggio quando viene richiamato il metodo Debug.Assert e permette, inoltre, di specificare il nome del file in cui scrivere i messaggi.
<performanceCounters>	Specifica la dimensione della memoria globale condivisa dai contatori delle prestazioni.
<sharedListeners>	Contiene i listener a cui può fare riferimento un qualsiasi elemento di origine o di traccia. I listener identificati come condivisi possono essere aggiunti alle origini o alle traccia in base al nome.
<sources>	Specifica le origini di traccia che danno inizio ai messaggi di tracciatura.
<switches>	Contiene opzioni di traccia e i livelli in cui vengono impostate.
<trace>	Contiene listener per la raccolta, la memorizzazione e l'invio di messaggi di tracciatura.

Elementi padre

Elemento	Descrizione
configuration	Elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

Esempio

Nell'esempio riportato di seguito viene illustrato come incorporare un'opzione e un listener di traccia all'interno dell'elemento <system.diagnostics>. L'opzione di traccia General è impostata sul livello TraceLevel.Error. Il listener di traccia myListener crea un file denominato MyListener.log e scrive l'output al suo interno.

Nota
In .NET Framework versione 2.0 è possibile utilizzare testo per specificare il valore di un'opzione,ad esempio true per BooleanSwitch o il testo che rappresenta un valore di enumerazione, come Error, per la classe TraceSwitch.La riga <add name="myTraceSwitch" value="Error" /> equivale 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>

Vedere anche

Riferimenti

Schema delle impostazioni di traccia e debug

Trace

Debug

Condividi tramite