TraceOptions Enumeration

Definition

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.TraceSource.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

Im folgenden Codebeispiel wird die Verwendung der TraceOptions -Enumeration zum programmgesteuerten Festlegen der TraceOutputOptions -Eigenschaft für einen Konsolenablaufverfolgungslistener veranschaulicht. Der Konsolenüberwachungslistener ist einer der Listener, die in der Listeners -Eigenschaft einer Ablaufverfolgungsquelle aufgelistet sind. 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 -Attributs traceOutputOptions 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 Ablaufverfolgungslistener zur Anwendungskonfigurationsdatei finden Sie unter <Listener>.

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

• Die EventLogTraceListener -Klasse, da sie dazu führen kann, dass eine große Menge von Daten in das Protokoll geschrieben wird.

• Die Write Methoden und WriteLine der ConsoleTraceListenerKlassen , DefaultTraceListenerund TextWriterTraceListener .

• Die Write Methoden und WriteLine der TraceListener -Klasse, wenn sie in einer abgeleiteten Klasse nicht überschrieben werden.