TraceOptions Výčet

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.TraceSource.dll

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

Callstack	32	Zapište zásobník volání, který je reprezentován návratnou StackTrace hodnotou vlastnosti.
DateTime	2	Zapište datum a čas.
LogicalOperationStack	1	Zapište zásobník logické operace, který je reprezentován návratnou LogicalOperationStack hodnotou vlastnosti.
None	0	Nezapisujte žádné prvky.
ProcessId	8	Zapište identitu procesu, která je reprezentována návratnou Id hodnotou vlastnosti.
ThreadId	16	Zapište identitu vlákna, která je reprezentována návratová hodnota ManagedThreadId vlastnosti pro aktuální vlákno.
Timestamp	4	Zapište časové razítko, které je reprezentováno návratnou GetTimestamp() hodnotou 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ů ve Listeners vlastnosti zdroje trasování. Tento příklad kódu je součástí většího příkladu 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í ve TraceOutputOptions vlastnosti.

Následující příklad ukazuje použití atributu traceOutputOptions k určení možností výstupu trasování pro ConsoleTraceListener. Použití konfiguračního souboru, jako je tento, 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í trasovacích naslouchacích procesů do konfiguračního souboru aplikace najdete v tématu <Naslouchací procesy>.

Výčet TraceOptions se nepoužívá v následujících třídách a metodách:

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

• Metody WriteConsoleTraceListenera WriteLine třídy , DefaultTraceListeneraTextWriterTraceListener.

• Metody WriteTraceListener a WriteLine třídy, pokud nejsou přepsány v odvozené třídě.