TraceOptions Wyliczenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Określa opcje danych śledzenia, które mają być zapisywane w danych wyjściowych śledzenia.
To wyliczenie obsługuje bitową kombinację jego wartości składowych.
public enum class TraceOptions
[System.Flags]
public enum TraceOptions
[<System.Flags>]
type TraceOptions =
Public Enum TraceOptions
- Dziedziczenie
- Atrybuty
Pola
Callstack | 32 | Napisz stos wywołań, który jest reprezentowany przez wartość StackTrace zwracaną właściwości. |
DateTime | 2 | Zapisz datę i godzinę. |
LogicalOperationStack | 1 | Zapisz stos operacji logicznych, który jest reprezentowany przez wartość LogicalOperationStack zwracaną właściwości. |
None | 0 | Nie zapisuj żadnych elementów. |
ProcessId | 8 | Zapisz tożsamość procesu, która jest reprezentowana przez wartość Id zwracaną właściwości. |
ThreadId | 16 | Zapisz tożsamość wątku, która jest reprezentowana przez wartość zwracaną właściwości dla bieżącego ManagedThreadId wątku. |
Timestamp | 4 | Zapisz znacznik czasu, który jest reprezentowany przez wartość GetTimestamp() zwracaną metody. |
Przykłady
Poniższy przykład kodu przedstawia użycie TraceOptions wyliczenia do programowego ustawiania TraceOutputOptions właściwości odbiornika śledzenia konsoli. Odbiornik śledzenia konsoli jest jednym z odbiorników wyliczanych we Listeners właściwości źródła śledzenia. Ten przykład kodu jest częścią większego przykładu udostępnionego TraceSource dla klasy .
ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;
ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack
Uwagi
To wyliczenie jest używane przez odbiorniki śledzenia w celu określenia, które opcje lub elementy powinny być uwzględnione w danych wyjściowych śledzenia. Odbiorniki śledzenia przechowują TraceOutputOptions opcje śledzenia we właściwości .
W poniższym przykładzie pokazano użycie atrybutu traceOutputOptions
w celu określenia opcji danych wyjściowych śledzenia dla elementu ConsoleTraceListener. Używanie pliku konfiguracji w następujący sposób jest możliwe tylko w aplikacjach .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>
Aby uzyskać szczegółowe informacje na temat dodawania odbiorników śledzenia do pliku konfiguracji aplikacji, zobacz <odbiorniki>.
Wyliczenie TraceOptions nie jest używane przez następujące klasy i metody:
Klasa EventLogTraceListener , ponieważ może to spowodować zapisanie dużej ilości danych w dzienniku.
Metody
Write
iWriteLine
ConsoleTraceListenerklas , DefaultTraceListeneri TextWriterTraceListener .Metody WriteTraceListener i WriteLine klasy, gdy nie są zastępowane w klasie pochodnej.