Condividi tramite

<trace> Elemento

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

<traccia system.diagnostics di configurazione><><>

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.

Attributes

Attribute Description
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 rientro.
useGlobalLock Attributo facoltativo.

Indica se deve essere utilizzato il blocco globale.

Attributo autoflush

Value Description
false Non scarica automaticamente il buffer di output. Si tratta dell'impostazione predefinita.
true Scarica automaticamente il buffer di output.

Attributo useGlobalLock

Value Description
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. Si tratta dell'impostazione predefinita.

Elementi figli

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

Elementi padre

Elemento Description
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 che raccolgono, archiviano e instradano i messaggi e il livello in cui è impostata un'opzione di traccia.

Example

Nell'esempio seguente viene illustrato come utilizzare 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 fa sì che il listener di traccia scriva nel file indipendentemente dal fatto che il Trace.Flush metodo venga chiamato. L'attributo indentsize è impostato su 0 (zero), che fa in modo 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>

Vedere anche

  • Last updated on