ConsoleTraceListener Constructor (Boolean)

 

Initializes a new instance of the ConsoleTraceListener class with an option to write trace output to the standard output stream or the standard error stream.

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

public ConsoleTraceListener(
	bool useErrorStream
)

Parameters

useErrorStream
Type: System.Boolean

true to write tracing and debugging output to the standard error stream; false to write tracing and debugging output to the standard output stream.

This constructor initializes a ConsoleTraceListener object to write messages to either the Console.Out or the Console.Error stream. Its Name property is initialized to an empty string ("").

The following code example initializes a ConsoleTraceListener object for the specified Console output stream and adds it to the trace listener collection. This code example is part of a larger example provided for the ConsoleTraceListener class.

// Define a trace listener to direct trace output from this method
// to the console.
ConsoleTraceListener consoleTracer;

// Check the command line arguments to determine which
// console stream should be used for trace output.
if ((CmdArgs.Length>0)&&(CmdArgs[0].ToString().ToLower().Equals("/stderr")))
    // Initialize the console trace listener to write
    // trace output to the standard error stream.
{
    consoleTracer = new ConsoleTraceListener(true);
}
else
{
    // Initialize the console trace listener to write
    // trace output to the standard output stream.
    consoleTracer = new ConsoleTraceListener();
}
// Set the name of the trace listener, which helps identify this 
// particular instance within the trace listener collection.
consoleTracer.Name = "mainConsoleTracer";

// Write the initial trace message to the console trace listener.
consoleTracer.WriteLine(DateTime.Now.ToString()+" ["+consoleTracer.Name+"] - Starting output to trace listener.");

// Add the new console trace listener to 
// the collection of trace listeners.
Trace.Listeners.Add(consoleTracer);

.NET Framework
Available since 2.0
Return to top
Show: