Export (0) Print
Expand All

List(T).Insert Method

Inserts an element into the List(T) at the specified index.

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

abstract Insert : 
        index:int * 
        item:'T -> unit  
override Insert : 
        index:int * 
        item:'T -> unit

Parameters

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 a null reference (Nothing in Visual Basic) for reference types.

Implements

IList(T).Insert(Int32, T)

ExceptionCondition
ArgumentOutOfRangeException

index is less than 0.

-or-

index is greater than Count.

List(T) accepts a null reference (Nothing in Visual Basic) as a valid value for reference types and allows duplicate elements.

If Count already equals Capacity, the capacity of the List(T) is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

If index is equal to Count, item is added to the end of List(T).

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

The following example demonstrates how to add, remove, and insert a simple business object in a List(T).

No code example is currently available or this language may not be supported.

The following example demonstrates the Insert method, along with various other properties and methods of the List(T) generic class. After the list is created, elements are added. The Insert method is used to insert an item into the middle of the list. The item inserted is a duplicate, which is later removed using the Remove method.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

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

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft