Collection<T>.Insert Method

.NET Framework 4.6 and 4.5

Inserts an element into the Collection<T> at the specified index.

Namespace: System.Collections.ObjectModel
Assembly: mscorlib (in mscorlib.dll)

Syntax

public void Insert(
	int index,
	T item
)

index: Type: System.Int32
The zero-based index at which item should be inserted.

item: Type: T
The object to insert. The value can be null for reference types.

Exception	Condition
ArgumentOutOfRangeException	index is less than zero. -or- index is greater than Count.

Exception

Condition

index is less than zero.

-or-

index is greater than Count.

Collection<T> accepts null as a valid value for reference types and allows duplicate elements.

If index is equal to Count, item is added to the end of Collection<T>.

This method is an O(n) operation, where n is Count.

Notes to Inheritors

Derived classes can override InsertItem to change the behavior of this method.

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

Supported in: 4, 3.5 SP1

Supported in: 3.0, 2.0, 1.0

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Supported in: Portable Class Library