This abstract class TraceListener is associated with a trace through inclusion in the Trace.Listeners collection. Each TraceListener is responsible for sending trace output somewhere. For example, when you call Trace.WriteLine( ), each TraceListener sends the same output to its respective output destination. Use Name to give a name to your TraceListener instances.

Use IndentLevel to control the level of indentation in the output. IndentSize specifies the number of spaces in each level of indent. NeedIndent toggles whether to indent the output at all. Use Write( ) and WriteLine( ) to send output to the TraceListener's destination. WriteIndent( ) emits whitespace according to the current IndentLevel and IndentSize. It has the side effect of setting NeedIndent to false, so the next time you call one of the Write* methods, it will not emit extra indentation.

You can use the application configuration file to add or remove TraceListeners. Look up System.Diagnostics.TraceListener in the .NET Framework SDK Documentation for details.

public abstract class TraceListener : MarshalByRefObject, IDisposable {
// Protected Constructors
   protected TraceListener( );
   protected TraceListener(string name);
// Public Instance Properties
   public int IndentLevel{set; get; }
   public int IndentSize{set; get; }
   public virtual string Name{set; get; }
// Protected Instance Properties
   protected bool NeedIndent{set; get; }
// Public Instance Methods
   public virtual void Close( );
   public void Dispose( ); 
// implements IDisposable
   public virtual void Fail(string message);
   public virtual void Fail(string message, string detailMessage);
   public virtual void Flush( );
   public virtual void Write(object o);
   public virtual void Write(object o, string category);
   public abstract void Write(string message);
   public virtual void Write(string message, string category);
   public virtual void WriteLine(object o);
   public virtual void WriteLine(object o, string category);
   public abstract void WriteLine(string message);
   public virtual void WriteLine(string message, string category);
// Protected Instance Methods
   protected virtual void Dispose(bool disposing);
   protected virtual void WriteIndent( );
}

Hierarchy

System.Object System.MarshalByRefObject TraceListener(System.IDisposable)

Subclasses

DefaultTraceListener, EventLogTraceListener, TextWriterTraceListener

Returned By

TraceListenerCollection.this

Passed To

TraceListenerCollection.{Add( ), AddRange( ), Contains( ), CopyTo( ), IndexOf( ), Insert( ), Remove( ), this}