TraceOptions Enumeration

  • Referenz

Definition

Namespace:
System.Diagnostics
Assembly:
System.Diagnostics.TraceSource.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Gibt Optionen für Ablaufverfolgungsdaten an, die in die Ablaufverfolgungsausgabe geschrieben werden sollen.

Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.

public enum class TraceOptions
[System.Flags]
public enum TraceOptions
[<System.Flags>]
type TraceOptions = 
Public Enum TraceOptions
Vererbung
Object
ValueType
Enum
TraceOptions
Attribute
FlagsAttribute

Felder

Callstack 32

Schreiben der Aufrufliste, die durch den Rückgabewert der StackTrace-Eigenschaft dargestellt wird.
DateTime 2

Schreiben des Datum und der Uhrzeit.
LogicalOperationStack 1

Schreiben des logischen Vorgangsstapels, der durch den Rückgabewert der LogicalOperationStack-Eigenschaft dargestellt wird.
None 0

Es werden keine Elemente geschrieben.
ProcessId 8

Schreiben der Prozessidentität, die durch den Rückgabewert der Id-Eigenschaft dargestellt wird.
ThreadId 16

Schreiben der Threadidentität, die durch den Rückgabewert der ManagedThreadId-Eigenschaft für den aktuellen Thread dargestellt wird.
Timestamp 4

Schreiben des Zeitstempels, der durch den Rückgabewert der GetTimestamp()-Methode dargestellt wird.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der TraceOptions Enumeration, um die TraceOutputOptions Eigenschaft für einen Konsolenablaufverfolgungslistener programmgesteuert festzulegen. Der Listener der Konsolenablaufverfolgung ist eine der Listener, die in der Listeners Eigenschaft einer Ablaufverfolgungsquelle aufgezählt wurden. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die TraceSource Klasse bereitgestellt wird.

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

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

Hinweise

Diese Enumeration wird von Ablaufverfolgungslistenern verwendet, um zu bestimmen, welche Optionen oder Elemente in die Ablaufverfolgungsausgabe einbezogen werden sollen. Ablaufverfolgungslistener speichern die Ablaufverfolgungsoptionen in der TraceOutputOptions Eigenschaft.

Das folgende Beispiel zeigt die Verwendung des traceOutputOptions Attributs zum Angeben der Ablaufverfolgungsausgabeoptionen für ein ConsoleTraceListener. Die Verwendung einer Konfigurationsdatei wie dieser ist nur in .NET Framework Apps möglich.

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

Ausführliche Informationen zum Hinzufügen von Ablaufverfolgungslistenern zur Anwendungskonfigurationsdatei finden Sie unter <listeners>.

Die TraceOptions Enumeration wird nicht von den folgenden Klassen und Methoden verwendet:

Gilt für: