TraceOptions Enum
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee geeft u opties voor traceringsgegevens op die naar de traceringsuitvoer moeten worden geschreven.
Deze opsomming ondersteunt een bitsgewijze combinatie van de waarden van de leden.
public enum class TraceOptions[System.Flags]
public enum TraceOptions[<System.Flags>]
type TraceOptions = Public Enum TraceOptions- Overname
- Kenmerken
Velden
| Name | Waarde | Description |
|---|---|---|
| None | 0 | Schrijf geen elementen. |
| LogicalOperationStack | 1 | Schrijf de logische bewerkingsstack, die wordt vertegenwoordigd door de retourwaarde van de LogicalOperationStack eigenschap. |
| DateTime | 2 | Schrijf de datum en tijd. |
| Timestamp | 4 | Schrijf de tijdstempel, die wordt vertegenwoordigd door de retourwaarde van de GetTimestamp() methode. |
| ProcessId | 8 | Schrijf de procesidentiteit, die wordt vertegenwoordigd door de retourwaarde van de Id eigenschap. |
| ThreadId | 16 | Schrijf de thread-identiteit, die wordt vertegenwoordigd door de retourwaarde van de ManagedThreadId eigenschap voor de huidige thread. |
| Callstack | 32 | Schrijf de aanroepstack, die wordt vertegenwoordigd door de retourwaarde van de StackTrace eigenschap. |
Voorbeelden
In het volgende codevoorbeeld ziet u het gebruik van de TraceOptions opsomming om de TraceOutputOptions eigenschap programmatisch in te stellen voor een consoletraceringlistener. De consoletraceringlistener is een van de listeners die zijn geïnventariseerd in de Listeners eigenschap van een traceringsbron. Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de TraceSource klasse.
ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;
ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack
Opmerkingen
Deze inventarisatie wordt gebruikt door traceringslisteners om te bepalen welke opties of elementen moeten worden opgenomen in de traceringsuitvoer. Traceerlisteners slaan de traceringsopties op in de TraceOutputOptions eigenschap.
In het volgende voorbeeld ziet u het gebruik van het traceOutputOptions kenmerk om de traceringsuitvoeropties voor een ConsoleTraceListenerop te geven. Het gebruik van een configuratiebestand als dit is alleen mogelijk in .NET Framework-apps.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="consoleListener"
type="System.Diagnostics.ConsoleTraceListener"
traceOutputOptions="ProcessId, DateTime" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Zie listeners voor meer informatie over het toevoegen van traceerlisteners aan het toepassingsconfiguratiebestand<.>
De TraceOptions opsomming wordt niet gebruikt door de volgende klassen en methoden:
De EventLogTraceListener klasse kan ertoe leiden dat een grote hoeveelheid gegevens naar het logboek wordt geschreven.
De
WriteenWriteLinemethoden van de ConsoleTraceListener, DefaultTraceListeneren TextWriterTraceListener klassen.De Write en WriteLine methoden van de TraceListener klasse wanneer ze niet worden overschreven in een afgeleide klasse.