TextWriterTraceListener Constructor (TextWriter)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Initializes a new instance of the TextWriterTraceListener class using the specified writer as recipient of the tracing or debugging output.

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

public TextWriterTraceListener(
	TextWriter writer


Type: System.IO.TextWriter

A TextWriter that receives the output from the TextWriterTraceListener.

Exception Condition

The writer is null.

This constructor initializes the Name property to an empty string ("").

The following code example creates a TextWriterTraceListener using the TextWriterTraceListener(TextWriter) constructor. The example creates a StreamWriter, then references the StreamWriter when it creates the TextWriterTraceListener, which it then adds to the TraceListenerCollection. The example writes a message to all TraceListener objects in the TraceListenerCollection, then closes this TextWriterTraceListener.

#define TRACE

using System;
using System.IO;
using System.Diagnostics;

public class TextWriterTraceListenerSample
    public static void Main() 
        TextWriterTraceListener myTextListener = null;

        // Create a file for output named TestFile.txt.
        String myFileName = "TestFile.txt";
        StreamWriter myOutputWriter = new StreamWriter(myFileName, true);

        // Add a TextWriterTraceListener for the file.
        myTextListener = new TextWriterTraceListener(myOutputWriter);

        // Write trace output to all trace listeners.
        Trace.WriteLine(DateTime.Now.ToString() + " - Trace output");

        // Remove and close the file writer/trace listener.

.NET Framework
Available since 1.1
Return to top