.NET Framework Class Library
CollectionTInsert Method

Inserts an element into the CollectionT at the specified index.

Namespace:   System.Collections.ObjectModel
Assembly:  mscorlib (in mscorlib.dll)
Syntax
Public Sub Insert ( _
	index As [%$TOPIC/ms132411_en-us_VS_110_2_0_0_0_0%], _
	item As T _
)
public void Insert(
	[%$TOPIC/ms132411_en-us_VS_110_2_0_1_0_0%] index,
	T item
)
public:
virtual void Insert(
	[%$TOPIC/ms132411_en-us_VS_110_2_0_2_0_0%] index, 
	T item
) sealed
abstract Insert : 
        index:[%$TOPIC/ms132411_en-us_VS_110_2_0_3_0_0%] * 
        item:'T -> unit  
override Insert : 
        index:[%$TOPIC/ms132411_en-us_VS_110_2_0_3_0_1%] * 
        item:'T -> unit
public final function Insert(
	index : [%$TOPIC/ms132411_en-us_VS_110_2_0_4_0_0%], 
	item : T
)

Parameters

index
Type: SystemInt32

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

item
Type: T

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

Implements

IListTInsert(Int32, T)
Exceptions
ExceptionCondition
ArgumentOutOfRangeException

index is less than zero.

-or-

index is greater than Count.

Remarks

CollectionT accepts as a valid value for reference types and allows duplicate elements.

If index is equal to Count, item is added to the end of CollectionT.

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.

Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8