This documentation is archived and is not being maintained.

TraceListener.TraceOutputOptions Property

Gets or sets the trace output options.

Namespace: System.Diagnostics
Assembly: System (in system.dll)

public TraceOptions TraceOutputOptions { get; set; }
/** @property */
public TraceOptions get_TraceOutputOptions ()

/** @property */
public void set_TraceOutputOptions (TraceOptions value)

public function get TraceOutputOptions () : TraceOptions

public function set TraceOutputOptions (value : TraceOptions)

Not applicable.

Property Value

A bitwise combination of the TraceOptions values. The default is None.

Exception typeCondition


Set operation failed because the value is invalid.

The TraceOutputOptions property determines the optional content of trace output. The property can be set in the configuration file or programmatically during execution to include additional data specifically for a section of code. For example, you can set the TraceOutputOptions property for the console trace listener to TraceOptions.Callstack to add call stack information to the trace output.


The TraceOutputOptions property is not used by the EventLogTraceListener because it can cause a large volume of data to be written to the log.

The following example shows the setting of the TraceOutputOptions property for a console trace listener. The console trace listener is one of the listeners enumerated in the Listeners property of a trace source. This code example is part of a larger example provided for the TraceSource class.

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

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0