Elemento <trace>

Articolo
08/11/2011

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

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

Attributi ed elementi

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

Attributi

Attributo	Descrizione
autoflush	Attributo facoltativo. Indica se i listener di traccia 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 traccia 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	Elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics	Consente di specificare listener di traccia per la raccolta, la memorizzazione e l'invio di messaggi, nonché il livello in cui viene impostata un'opzione di traccia.

Esempio

Nell'esempio riportato di seguito viene illustrato come utilizzare l'elemento <trace> per aggiungere il listener MyListener all'insieme Listeners. MyListener crea un file denominato MyListener.log e scrive l'output al suo interno. L'attributo useGlobalLock è impostato su false, quindi il blocco globale non viene utilizzato se il listener di traccia è thread-safe. L'attributo autoflush è impostato su true, quindi il listener di traccia 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>