TraceOptions Enumeration

Definition

Namespace:

System.Diagnostics

Assemblys:

netstandard.dll, System.Diagnostics.TraceSource.dll

Quelle:

TraceOptions.cs

Gibt Ablaufverfolgungsdatenoptionen 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

Name	Wert	Beschreibung
None	0	Schreiben Sie keine Elemente.
LogicalOperationStack	1	Schreiben Sie den logischen Vorgangsstapel, der durch den Rückgabewert der LogicalOperationStack Eigenschaft dargestellt wird.
DateTime	2	Schreiben Sie das Datum und die Uhrzeit.
Timestamp	4	Schreiben Sie den Zeitstempel, der durch den Rückgabewert der GetTimestamp() Methode dargestellt wird.
ProcessId	8	Schreiben Sie die Prozessidentität, die durch den Rückgabewert der Id Eigenschaft dargestellt wird.
ThreadId	16	Schreiben Sie die Threadidentität, die durch den Rückgabewert der ManagedThreadId Eigenschaft für den aktuellen Thread dargestellt wird.
Callstack	32	Schreiben Sie den Aufrufstapel, der durch den Rückgabewert der StackTrace Eigenschaft dargestellt wird.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung der TraceOptions Enumeration zum programmgesteuerten Festlegen der TraceOutputOptions Eigenschaft für einen Konsolenablaufverfolgungslistener. Der Listener der Konsolenablaufverfolgung 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 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 <Listener>.

Die TraceOptions Aufzählung wird von den folgenden Klassen und Methoden nicht verwendet:

• Die EventLogTraceListener Klasse, da sie dazu führen kann, dass ein großes Datenvolumen in das Protokoll geschrieben wird.

• Die Write Methoden und WriteLine Methoden von ConsoleTraceListener, DefaultTraceListenerund TextWriterTraceListener Klassen.

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