<Elemento trace>

Articolo
04/08/2023

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>

Condividi tramite