Inserts an element into the List(T) at the specified index.
Assembly: mscorlib (in mscorlib.dll)
abstract Insert : index:int * item:'T -> unit override Insert : index:int * item:'T -> unit
- Type: System.Int32
The zero-based index at which item should be inserted.
- Type: T
The object to insert. The value can be a null reference (Nothing in Visual Basic) for reference types.
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.
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).
The following example demonstrates the method, along with various other properties and methods of the List(T) generic class. After the list is created, elements are added. The 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.
.NET FrameworkSupported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0
.NET Framework Client ProfileSupported in: 4, 3.5 SP1
Portable Class LibrarySupported in: Portable Class Library
.NET for Windows Store appsSupported in: Windows 8
.NET for Windows Phone appsSupported 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.