TraceOptions Enum
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Anger alternativ för spårningsdata som ska skrivas till spårningsutdata.
Den här uppräkningen stöder en bitvis kombination av dess medlemsvärden.
public enum class TraceOptions[System.Flags]
public enum TraceOptions[<System.Flags>]
type TraceOptions = Public Enum TraceOptions- Arv
- Attribut
Fält
| Name | Värde | Description |
|---|---|---|
| None | 0 | Skriv inga element. |
| LogicalOperationStack | 1 | Skriv den logiska åtgärdsstacken, som representeras av egenskapens LogicalOperationStack returvärde. |
| DateTime | 2 | Skriv datum och tid. |
| Timestamp | 4 | Skriv tidsstämpeln, som representeras av metodens returvärde GetTimestamp() . |
| ProcessId | 8 | Skriv processidentiteten, som representeras av egenskapens returvärde Id . |
| ThreadId | 16 | Skriv trådidentiteten, som representeras av returvärdet ManagedThreadId för egenskapen för den aktuella tråden. |
| Callstack | 32 | Skriv anropsstacken, som representeras av egenskapens StackTrace returvärde. |
Exempel
I följande kodexempel visas användningen av TraceOptions uppräkningen för att programmatiskt ange TraceOutputOptions egenskapen för en konsolspårningslyssnare. Konsolens spårningslyssnare är en av lyssnarna som räknas upp i Listeners egenskapen för en spårningskälla. Det här kodexemplet är en del av ett större exempel för TraceSource klassen.
ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;
ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack
Kommentarer
Den här uppräkningen används av spårningslyssnare för att avgöra vilka alternativ eller element som ska ingå i spårningsutdata. Spårningslyssnare lagrar spårningsalternativen i egenskapen TraceOutputOptions .
I följande exempel visas hur attributet används traceOutputOptions för att ange alternativen för spårningsutdata för en ConsoleTraceListener. Det går bara att använda en konfigurationsfil som den här i .NET Framework-appar.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="consoleListener"
type="System.Diagnostics.ConsoleTraceListener"
traceOutputOptions="ProcessId, DateTime" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Mer information om hur du lägger till spårningslyssnare i programkonfigurationsfilen finns i <lyssnare>.
Uppräkningen TraceOptions används inte av följande klasser och metoder:
Klassen EventLogTraceListener , eftersom den kan orsaka att en stor mängd data skrivs till loggen.
Metoderna
WriteochWriteLineför klasserna ConsoleTraceListener, DefaultTraceListeneroch TextWriterTraceListener .Metoderna Write och WriteLine för TraceListener klassen när de inte åsidosättas i en härledd klass.