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

Reference

Definition

Namespace:: System.Collections.ObjectModel

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: Collection.cs

Source:: Collection.cs

Source:: Collection.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

Insert(Int32, T)

Exceptions

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

Delen via