TraceOptions Výčet

Definice

Obor názvů:

System.Diagnostics

Sestavení:

netstandard.dll, System.Diagnostics.TraceSource.dll

Zdroj:

TraceOptions.cs

Určuje možnosti trasování dat, které se mají zapisovat 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

Object

ValueType

Enum

TraceOptions

Atributy

FlagsAttribute

Pole

Name	Hodnota	Description
None	0	Nezapisujte žádné prvky.
LogicalOperationStack	1	Zapište zásobník logických LogicalOperationStack operací, který je reprezentován vrácenou hodnotou vlastnosti.
DateTime	2	Napište datum a čas.
Timestamp	4	Zapište časové razítko, které je reprezentováno návratovými hodnotami GetTimestamp() metody.
ProcessId	8	Napište identitu procesu, která je reprezentována vrácenou hodnotou Id vlastnosti.
ThreadId	16	Zapište identitu vlákna, která je reprezentována vrácenou hodnotou ManagedThreadId vlastnosti pro aktuální vlákno.
Callstack	32	Napište zásobník volání, který je reprezentován vrácenou hodnotou StackTrace vlastnosti.

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ů ve Listeners vlastnosti zdroje trasování. Tento příklad kódu je součástí většího příkladu uvedeného pro třídu TraceSource.

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í možností nebo prvků, které mají být zahrnuty do výstupu trasování. Naslouchací procesy trasování ukládají možnosti trasování ve TraceOutputOptions vlastnosti.

Následující příklad ukazuje použití traceOutputOptions atributu k určení možnosti výstupu trasování pro a ConsoleTraceListener. Použití podobného konfiguračního souboru je možné pouze v aplikacích .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>

Podrobnosti o přidání naslouchacích procesů trasování do konfiguračního souboru aplikace najdete v tématu <naslouchací> procesy.

Výčet TraceOptions není používán následujícími třídami a metodami:

• Třída EventLogTraceListener , protože může způsobit zápis velkého objemu dat do protokolu.

• WriteLine A Write metody ConsoleTraceListener, DefaultTraceListenera TextWriterTraceListener třídy.

• Metody Write třídy WriteLineTraceListener , pokud nejsou přepsány v odvozené třídě.