TraceOptions Enumerazione

Definizione

Spazio dei nomi:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.dll

Specifica le opzioni relative ai dati di traccia da scrivere nell'output di traccia.

Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.

public enum class TraceOptions

[System.Flags]
public enum TraceOptions

[<System.Flags>]
type TraceOptions = 

Public Enum TraceOptions

Ereditarietà

Object

ValueType

Enum

TraceOptions

Attributi

FlagsAttribute

Campi

Callstack	32	Scrivere lo stack di chiamate, che è rappresentato dal valore restituito della proprietà StackTrace.
DateTime	2	Scrivere la data e l'ora.
LogicalOperationStack	1	Scrivere lo stack di operazioni logiche, che è rappresentato dal valore restituito della proprietà LogicalOperationStack.
None	0	Non scrivere alcun elemento.
ProcessId	8	Scrivere l'identità del processo, che è rappresentata dal valore restituito della proprietà Id.
ThreadId	16	Scrivere l'identità del thread, che è rappresentata dal valore restituito della proprietà ManagedThreadId per il thread corrente.
Timestamp	4	Scrivere il timestamp, che è rappresentato dal valore restituito del metodo GetTimestamp().

Esempio

Nell'esempio di codice seguente viene illustrato l'uso dell'enumerazione TraceOptions per impostare a livello di codice la TraceOutputOptions proprietà per un listener di traccia della console. Il listener di traccia della console è uno dei listener enumerati nella proprietà di un'origine Listeners di traccia. Questo esempio di codice fa parte di un esempio più grande fornito per la TraceSource classe.

ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;

ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack

Commenti

Questa enumerazione viene usata dai listener di traccia per determinare quali opzioni, o elementi, devono essere incluse nell'output di traccia. I listener di traccia archiviano le opzioni di traccia nella TraceOutputOptions proprietà .

Nell'esempio seguente viene illustrato l'uso dell'attributo traceOutputOptions per specificare le opzioni di output di traccia per un ConsoleTraceListeneroggetto . L'uso di un file di configurazione simile a questo è possibile solo nelle app .NET Framework.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="consoleListener"  
          type="System.Diagnostics.ConsoleTraceListener"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Per informazioni dettagliate sull'aggiunta di listener di traccia al file di configurazione dell'applicazione, vedere <Listener>.

L'enumerazione TraceOptions non viene usata dalle classi e dai metodi seguenti:

• La EventLogTraceListener classe, perché può causare la scrittura di un volume elevato di dati nel log.

• Metodi Write e WriteLine delle ConsoleTraceListenerclassi , DefaultTraceListenere TextWriterTraceListener .

• I Write metodi e WriteLine della TraceListener classe quando non vengono sottoposti a override in una classe derivata.