TraceOptions Перечисление

Определение

Пространство имен:

System.Diagnostics

Сборка:

System.Diagnostics.TraceSource.dll

Задает параметры данных трассировки, записываемые в выходные данные трассировки.

Это перечисление поддерживает побитовую комбинацию значений его членов.

public enum class TraceOptions

[System.Flags]
public enum TraceOptions

[<System.Flags>]
type TraceOptions = 

Public Enum TraceOptions

Наследование

Object

ValueType

Enum

TraceOptions

Атрибуты

FlagsAttribute

Поля

Callstack	32	Записывает стек вызова, представленный возвращаемым значением свойства StackTrace.
DateTime	2	Записывает дату и время.
LogicalOperationStack	1	Записывает стек логических операций, представленный возвращаемым значением свойства LogicalOperationStack.
None	0	Не записывает элементы.
ProcessId	8	Записывает стек идентификации процесса, представленный возвращаемым значением свойства Id.
ThreadId	16	Записывает стек удостоверений процесса, представленный возвращаемым значением свойства ManagedThreadId для текущего потока.
Timestamp	4	Записывает отметку времени, представленную возвращаемым значением метода GetTimestamp().

Примеры

В следующем примере кода показано использование перечисления TraceOptions для программной TraceOutputOptions установки свойства для прослушивателя трассировки консоли. Прослушиватель трассировки консоли является одним из прослушивателей, перечисленных в свойстве Listeners источника трассировки. Этот пример входит в состав более крупного примера использования класса TraceSource.

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

ts.Listeners("console").TraceOutputOptions = ts.Listeners("console").TraceOutputOptions Or TraceOptions.Callstack

Комментарии

Это перечисление используется прослушивателями трассировки, чтобы определить, какие параметры или элементы должны быть включены в выходные данные трассировки. Прослушиватели трассировки сохраняют параметры трассировки в свойстве TraceOutputOptions .

В следующем примере показано использование атрибута traceOutputOptions для указания параметров вывода трассировки ConsoleTraceListenerдля . Использовать такой файл конфигурации можно только в платформа .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>  

Дополнительные сведения о добавлении прослушивателей трассировки в файл конфигурации приложения см. в разделе <Прослушиватели>.

Перечисление TraceOptions не используется следующими классами и методами:

• Класс EventLogTraceListener , так как он может привести к записи большого объема данных в журнал.

• Методы WriteConsoleTraceListenerи WriteLine классов , DefaultTraceListenerи TextWriterTraceListener .

• Методы Write и WriteLine класса , TraceListener если они не переопределены в производном классе.