TraceOptions Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- Attribute
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
WriteMethoden undWriteLineMethoden von ConsoleTraceListener, DefaultTraceListenerund TextWriterTraceListener Klassen.Die Write Methoden WriteLine und Methoden der TraceListener Klasse, wenn sie in einer abgeleiteten Klasse nicht überschrieben werden.
