Export (0) Print
Expand All

ConsoleTraceListener.ConsoleTraceListener(Boolean) Constructor

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
)
public ConsoleTraceListener (
	boolean useErrorStream
)
public function ConsoleTraceListener (
	useErrorStream : boolean
)
Not applicable.

Parameters

useErrorStream

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);

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

Community Additions

ADD
Show:
© 2014 Microsoft