List(T) Constructor (Int32)
Initializes a new instance of the List(T) class that is empty and has the specified initial capacity.
Assemblies: mscorlib (in mscorlib.dll)
System.Collections (in System.Collections.dll)
The capacity of a List(T) is the number of elements that the List(T) can hold. As elements are added to a List(T), the capacity is automatically increased as required by reallocating the internal array.
If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the List(T).
This constructor is an O(n) operation, where n is capacity.
The following example demonstrates the constructor. A List(T) of strings with a capacity of 4 is created, because the ultimate size of the list is known to be exactly 4. The list is populated with four strings, and a read-only copy is created by using the AsReadOnly method.
.NET FrameworkSupported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0
.NET Framework Client ProfileSupported in: 4, 3.5 SP1
XNA FrameworkSupported in: 3.0, 2.0, 1.0
Portable Class LibrarySupported in: Portable Class Library
Supported in: Windows Phone 8.1
Supported in: Windows Phone Silverlight 8.1
Supported in: Windows Phone Silverlight 8