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

Definition

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

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

item
T

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

Implements

Exceptions

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