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 ，因为它可能导致将大量数据写入日志。

• Write、 DefaultTraceListener和 WriteLine 类的 ConsoleTraceListener和 TextWriterTraceListener 方法。

• Write类的 TraceListener 和 WriteLine 方法（在派生类中未重写时）。