TraceListener.TraceOutputOptions 属性

定义

命名空间:

System.Diagnostics

程序集:

System.Diagnostics.TraceSource.dll

Source:

TraceListener.cs

获取或设置跟踪输出选项。

public:
 property System::Diagnostics::TraceOptions TraceOutputOptions { System::Diagnostics::TraceOptions get(); void set(System::Diagnostics::TraceOptions value); };

public System.Diagnostics.TraceOptions TraceOutputOptions { get; set; }

member this.TraceOutputOptions : System.Diagnostics.TraceOptions with get, set

Public Property TraceOutputOptions As TraceOptions

属性值

TraceOptions

枚举值的按位组合。 默认值为 None。

例外

ArgumentOutOfRangeException

Set 操作失败，因为值无效。

示例

以下示例演示控制台跟踪侦听器的 属性的设置 TraceOutputOptions 。 控制台跟踪侦听器是在跟踪源的 属性中 Listeners 枚举的侦听器之一。 此代码示例是为 TraceSource 类提供的一个更大示例的一部分。

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

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

注解

属性 TraceOutputOptions 确定跟踪输出的可选内容。 属性可以在配置文件中设置，也可以在执行期间以编程方式进行设置，以包含专用于代码部分的其他数据。 例如，可以将控制台跟踪侦听器的 属性设置为 TraceOutputOptions ， TraceOptions.Callstack 以便将调用堆栈信息添加到跟踪输出。

TraceOptions以下类和方法不使用枚举：

• 类 EventLogTraceListener ，因为它可能会导致大量数据写入日志。

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

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