This documentation is archived and is not being maintained.

TraceListenerCollection.Insert Method

Inserts the listener at the specified index.

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

public void Insert (
	int index,
	TraceListener listener
public void Insert (
	int index, 
	TraceListener listener
public function Insert (
	index : int, 
	listener : TraceListener
Not applicable.



The position in the list to insert the new TraceListener.


A TraceListener to insert in the list.

Exception typeCondition


The index is not a valid index in the list.


listener is a null reference (Nothing in Visual Basic).

If the index equals the number of items in the list, then the listener is appended to the end of the list.

The index is zero-based. Therefore, if you want to insert the listener into the third position, you must call myTraceListenerColl.Insert(2, myNewListener).

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0