TraceOptions Wyliczenie

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.TraceSource.dll

Określa opcje danych śledzenia, które mają być zapisywane w danych wyjściowych śledzenia.

To wyliczenie obsługuje bitową kombinację jego wartości składowych.

C#

[System.Flags]
public enum TraceOptions

Dziedziczenie

Object

ValueType

Enum

TraceOptions

Atrybuty

FlagsAttribute

Pola

Nazwa	Wartość	Opis
Callstack	32	Napisz stos wywołań, który jest reprezentowany przez wartość StackTrace zwracaną właściwości.
DateTime	2	Zapisz datę i godzinę.
LogicalOperationStack	1	Zapisz stos operacji logicznych, który jest reprezentowany przez wartość LogicalOperationStack zwracaną właściwości.
None	0	Nie zapisuj żadnych elementów.
ProcessId	8	Zapisz tożsamość procesu, która jest reprezentowana przez wartość Id zwracaną właściwości.
ThreadId	16	Zapisz tożsamość wątku, która jest reprezentowana przez wartość zwracaną właściwości dla bieżącego ManagedThreadId wątku.
Timestamp	4	Zapisz znacznik czasu, który jest reprezentowany przez wartość GetTimestamp() zwracaną metody.

Przykłady

Poniższy przykład kodu przedstawia użycie TraceOptions wyliczenia do programowego ustawiania TraceOutputOptions właściwości odbiornika śledzenia konsoli. Odbiornik śledzenia konsoli jest jednym z odbiorników wyliczanych we Listeners właściwości źródła śledzenia. Ten przykład kodu jest częścią większego przykładu udostępnionego TraceSource dla klasy .

C#

ts.Listeners["console"].TraceOutputOptions |= TraceOptions.Callstack;

Uwagi

To wyliczenie jest używane przez odbiorniki śledzenia w celu określenia, które opcje lub elementy powinny być uwzględnione w danych wyjściowych śledzenia. Odbiorniki śledzenia przechowują TraceOutputOptions opcje śledzenia we właściwości .

W poniższym przykładzie pokazano użycie atrybutu traceOutputOptions w celu określenia opcji danych wyjściowych śledzenia dla elementu ConsoleTraceListener. Używanie pliku konfiguracji w następujący sposób jest możliwe tylko w aplikacjach .NET Framework.

XML

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="consoleListener"  
          type="System.Diagnostics.ConsoleTraceListener"   
          traceOutputOptions="ProcessId, DateTime" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>  

Aby uzyskać szczegółowe informacje na temat dodawania odbiorników śledzenia do pliku konfiguracji aplikacji, zobacz <odbiorniki>.

Wyliczenie TraceOptions nie jest używane przez następujące klasy i metody:

• Klasa EventLogTraceListener , ponieważ może to spowodować zapisanie dużej ilości danych w dzienniku.

• Metody Write i WriteLineConsoleTraceListenerklas , DefaultTraceListeneri TextWriterTraceListener .

• Metody WriteTraceListener i WriteLine klasy, gdy nie są zastępowane w klasie pochodnej.

Dotyczy