TraceOptions Výčet
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje možnosti trasování dat, které se mají zapsat do výstupu trasování.
Tento výčet podporuje bitové kombinace hodnot jeho členů.
public enum class TraceOptions
[System.Flags]
public enum TraceOptions
[<System.Flags>]
type TraceOptions =
Public Enum TraceOptions
- Dědičnost
- Atributy
Pole
Callstack | 32 | Napište zásobník volání, který je reprezentován návratnou hodnotou StackTrace vlastnosti. |
DateTime | 2 | Napište datum a čas. |
LogicalOperationStack | 1 | Zapište zásobník logických operací, který je reprezentován návratnou hodnotou LogicalOperationStack vlastnosti. |
None | 0 | Nezapisujte žádné prvky. |
ProcessId | 8 | Zapište identitu procesu, která je reprezentována návratnou hodnotou Id vlastnosti. |
ThreadId | 16 | Zapište identitu vlákna, která je reprezentována návratovou hodnotou ManagedThreadId vlastnosti pro aktuální vlákno. |
Timestamp | 4 | Napište časové razítko, které je reprezentováno návratnou hodnotou GetTimestamp() metody. |
Příklady
Následující příklad kódu ukazuje použití výčtu TraceOptions k programovému nastavení TraceOutputOptions vlastnosti pro naslouchací proces trasování konzoly. Naslouchací proces trasování konzoly je jedním z naslouchacích procesů, které jsou výčtem vlastnosti Listeners zdroje trasování. Tento příklad kódu je součástí většího příkladu poskytnutého TraceSource pro třídu.
ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;
ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack
Poznámky
Tento výčet používají naslouchací procesy trasování k určení, které možnosti nebo prvky by měly být zahrnuty do výstupu trasování. Naslouchací procesy trasování ukládají možnosti trasování do TraceOutputOptions vlastnosti.
Následující příklad ukazuje použití atributu traceOutputOptions
k určení možnosti výstupu trasování pro ConsoleTraceListener. Použití konfiguračního souboru, jako je tento, je možné pouze v .NET Framework aplikacích.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<add name="consoleListener"
type="System.Diagnostics.ConsoleTraceListener"
traceOutputOptions="ProcessId, DateTime" />
</listeners>
</trace>
</system.diagnostics>
</configuration>
Podrobnosti o přidání naslouchacích procesů trasování do konfiguračního souboru aplikace naleznete v tématu <listeners>.
Výčet TraceOptions nepoužívá následující třídy a metody:
Třída EventLogTraceListener , protože může způsobit zápis velkého objemu dat do protokolu.
WriteLine
AWrite
metody ConsoleTraceListener, DefaultTraceListenera TextWriterTraceListener třídy.WriteLine TraceListener Metody Write třídy, pokud nejsou přepsány v odvozené třídě.