<Elemento trace>

  • Articolo

Contiene i listener che raccolgono, archiviano e indirizzano i messaggi di traccia.

<Configurazione>
  <system.diagnostics>
    <Traccia>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
autoflush Attributo facoltativo.

Specifica se i listener di traccia scaricano automaticamente il buffer di output dopo ogni operazione di scrittura.
indentsize Attributo facoltativo.

Specifica il numero di spazi da impostare come rientro.
useGlobalLock Attributo facoltativo.

Indica se deve essere utilizzato il blocco globale.

Attributo autoflush

Valore Descrizione
false Non scarica automaticamente il buffer di output. Questo è il valore predefinito.
true Scarica automaticamente il buffer di output.

Attributo useGlobalLock

Valore Descrizione
false Non usa il blocco globale se il listener è thread-safe; in caso contrario, usa il blocco globale.
true Usa il blocco globale indipendentemente dal fatto che il listener sia thread-safe. Questo è il valore predefinito.

Elementi figlio

Elemento Descrizione
<Ascoltatori> Specifica un listener che raccoglie, archivia e instrada i messaggi.

Elementi padre

Elemento Descrizione
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.
system.diagnostics Specifica i listener di traccia per raccogliere, archiviare e indirizzare i messaggi, oltre al livello di impostazione di un'opzione di traccia.

Esempio

Nell'esempio seguente viene illustrato come usare l'elemento <trace> per aggiungere il listener MyListener alla Listeners raccolta. MyListener crea un file denominato MyListener.log e scrive l'output nel file. L'attributo useGlobalLock è impostato su false, che causa l'uso del blocco globale se il listener di traccia è thread-safe. L'attributo autoflush è impostato su true, che determina la scrittura del listener di traccia nel file indipendentemente dal fatto che il Trace.Flush metodo venga chiamato. L'attributo indentsize è impostato su 0 (zero), che fa sì che il listener indenti gli spazi zero quando viene chiamato il Trace.Indent metodo.

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

Vedi anche