TextWriterTraceListener Constructor (TextWriter)

 
System_CAPS_noteNote

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
)

Parameters

writer
Type: System.IO.TextWriter

A TextWriter that receives the output from the TextWriterTraceListener.

Exception Condition
ArgumentNullException

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);
        Trace.Listeners.Add(myTextListener);


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

        // Remove and close the file writer/trace listener.
        myTextListener.Flush();
        Trace.Listeners.Remove(myTextListener);
        myTextListener.Close();
    }
}

.NET Framework
Available since 1.1
Return to top
Show: