TraceListener.TraceOutputOptions Property

Definition

Namespace:

System.Diagnostics

Assemblies:

netstandard.dll, System.Diagnostics.TraceSource.dll

Source:

TraceListener.cs

Gets or sets the trace output options.

C#

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

Property Value

TraceOptions

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

Exceptions

ArgumentOutOfRangeException

Set operation failed because the value is invalid.

Examples

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.

C#

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

Remarks

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 TraceOptions enumeration is not used by the following classes and methods:

• The EventLogTraceListener class, because it can cause a large volume of data to be written to the log.

• The Write and WriteLine methods of the ConsoleTraceListener, DefaultTraceListener, and TextWriterTraceListener classes.

• The Write and WriteLine methods of the TraceListener class when they are not overridden in a derived class.

Applies to