Collection<T>.Insert(Int32, T) Collection<T>.Insert(Int32, T) Collection<T>.Insert(Int32, T) Collection<T>.Insert(Int32, T) Method

Definition

Namespace:
System.Collections.ObjectModel System.Collections.ObjectModel System.Collections.ObjectModel System.Collections.ObjectModel
Assemblies:
System.Runtime.dll, mscorlib.dll, netstandard.dll

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

public:
 virtual void Insert(int index, T item);
public void Insert (int index, T item);
abstract member Insert : int * 'T -> unit
override this.Insert : int * 'T -> unit
Public Sub Insert (index As Integer, item As T)

Parameters

index
Int32 Int32 Int32 Int32

The zero-based index at which item should be inserted.

item
T T T T

The object to insert. The value can be null for reference types.

Implements

Insert(Int32, T)

Exceptions

ArgumentOutOfRangeException ArgumentOutOfRangeException ArgumentOutOfRangeException ArgumentOutOfRangeException

index is less than zero.

-or-

index is greater than Count.

Remarks

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(Int32, T) to change the behavior of this method.

Applies to

See also