This documentation is archived and is not being maintained.

ConsoleTraceListener Constructor

Initializes a new instance of the ConsoleTraceListener class with trace output written to the standard output stream.

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

public ConsoleTraceListener()

This constructor initializes a ConsoleTraceListener object to write messages to the Console.Out 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 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: