Trace::Listeners Property

 

Gets the collection of listeners that is monitoring the trace output.

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

public:
property TraceListenerCollection^ Listeners {
	[HostProtectionAttribute(SecurityAction::LinkDemand, SharedState = true)]
	static TraceListenerCollection^ get();
}

Property Value

Type: System.Diagnostics::TraceListenerCollection^

A TraceListenerCollection that represents a collection of type TraceListener monitoring the trace output.

The listeners produce formatted output from the trace output. By default, the collection contains an instance of the DefaultTraceListener class. If you want to remove the default listener, call the Remove method, and pass it the instance of the DefaultTraceListener. To redirect output to the console window, add an instance of the ConsoleTraceListener class.

System_CAPS_noteNote

The Listeners collection is shared by both the Debug and the Trace classes; adding a trace listener to either class adds the listener to both.

The following example creates a ConsoleTraceListener that outputs to the console screen. The code then adds the new listener to the Listeners.

// Create a ConsoletTraceListener and add it to the trace listeners.
#if defined(TRACE)
ConsoleTraceListener^ myWriter = gcnew ConsoleTraceListener( );
Trace::Listeners->Add( myWriter );
#endif

SecurityPermission

for operating with unmanaged code. Security action: Demand. Associated enumeration: SecurityPermissionFlag::UnmanagedCode

.NET Framework
Available since 1.1
Return to top
Show: