TraceOptions Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Указывает параметры данных трассировки для записи в выходные данные трассировки.
Это перечисление поддерживает побитовую комбинацию значений его членов.
public enum class TraceOptions
[System.Flags]
public enum TraceOptions
[<System.Flags>]
type TraceOptions =
Public Enum TraceOptions
- Наследование
- Атрибуты
Поля
| Имя | Значение | Описание |
|---|---|---|
| None | 0 | Не записывайте элементы. |
| LogicalOperationStack | 1 | Напишите стек логических операций LogicalOperationStack , представленный возвращаемым значением свойства. |
| DateTime | 2 | Напишите дату и время. |
| Timestamp | 4 | Напишите метку времени, представленную возвращаемым значением GetTimestamp() метода. |
| ProcessId | 8 | Напишите удостоверение процесса, которое представлено возвращаемым значением Id свойства. |
| ThreadId | 16 | Напишите удостоверение потока, которое представлено возвращаемым значением свойства для текущего ManagedThreadId потока. |
| Callstack | 32 | Напишите стек вызовов, который представлен возвращаемым значением StackTrace свойства. |
Примеры
В следующем примере кода показано использование перечисления 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 , так как он может привести к записи большого объема данных в журнал.
Методы
Writeи методы ConsoleTraceListenerDefaultTraceListener, а также TextWriterTraceListenerWriteLineклассы.Методы WriteWriteLineTraceListener класса, если они не переопределяются в производном классе.