Elemento <trace>

Articolo
09/12/2008

Aggiornamento: novembre 2007

Contiene listener per la raccolta, la memorizzazione e l'invio di messaggi di analisi.

Elemento <Configuration>
Elemento <system.diagnostics>
Elemento <trace>

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

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Attributo	Descrizione
autoflush	Attributo facoltativo. Indica se i listener di analisi svuotano automaticamente il buffer di output dopo ogni operazione di scrittura.
indentsize	Attributo facoltativo. Specifica il numero di spazi da utilizzare per il rientro.
useGlobalLock	Attributo facoltativo. Indica se utilizzare il blocco globale.

autoflush

Attributo facoltativo.

Indica se i listener di analisi svuotano automaticamente il buffer di output dopo ogni operazione di scrittura.

indentsize

Attributo facoltativo.

Specifica il numero di spazi da utilizzare per il rientro.

useGlobalLock

Attributo facoltativo.

Indica se utilizzare il blocco globale.

Attributo autoflush

Valore	Descrizione
false	Il buffer di output non viene svuotato automaticamente. Questa è l'impostazione predefinita.
true	Il buffer di output viene svuotato automaticamente.

Attributo useGlobalLock

Valore	Descrizione
false	Non utilizza il blocco globale se il listener è thread-safe; in caso contrario, utilizza il blocco globale.
true	Utilizza il blocco globale indipendentemente dal fatto che il listener sia thread-safe. Questa è l'impostazione predefinita.

Elementi figlio

Elemento	Descrizione
<listeners>	Consente di specificare un listener per la raccolta, la memorizzazione e l'invio di messaggi.

Elementi padre

Elemento	Descrizione
configuration	È l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Consente di specificare listener di analisi per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di analisi.

Esempio

Nell'esempio seguente viene illustrato l'utilizzo dell'elemento <trace> per aggiungere il listener MyListener all'insieme Listeners. MyListener consente di creare un file denominato MyListener.log in cui scrivere l'output. L'attributo useGlobalLock è impostato su false, quindi il blocco globale non viene utilizzato se il listener di analisi è thread-safe. L'attributo autoflush è impostato su true, quindi il listener di analisi scrive all'interno del file indipendentemente dal fatto che sia stato chiamato il metodo Trace.Flush. L'attributo indentsize è impostato su 0 (zero), quindi il listener non utilizza alcuno spazio per il rientro quando viene chiamato il metodo Trace.Indent.

<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>