ArrayList Constructors

Definition

Initializes a new instance of the ArrayList class.

Overloads

ArrayList()

Initializes a new instance of the ArrayList class that is empty and has the default initial capacity.

ArrayList(ICollection)

Initializes a new instance of the ArrayList class that contains elements copied from the specified collection and that has the same initial capacity as the number of elements copied.

ArrayList(Int32)

Initializes a new instance of the ArrayList class that is empty and has the specified initial capacity.

ArrayList()

Initializes a new instance of the ArrayList class that is empty and has the default initial capacity.

public:
 ArrayList();
public ArrayList ();
Public Sub New ()

Remarks

The capacity of an ArrayList is the number of elements that the ArrayList can hold. As elements are added to an ArrayList, 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 ArrayList.

This constructor is an O(1) operation.

See also

Applies to

ArrayList(ICollection)

Initializes a new instance of the ArrayList class that contains elements copied from the specified collection and that has the same initial capacity as the number of elements copied.

public:
 ArrayList(System::Collections::ICollection ^ c);
public ArrayList (System.Collections.ICollection c);
new System.Collections.ArrayList : System.Collections.ICollection -> System.Collections.ArrayList
Public Sub New (c As ICollection)

Parameters

c
ICollection

The ICollection whose elements are copied to the new list.

Exceptions

c is a multidimensional array.

Remarks

The capacity of an ArrayList is the number of elements that the ArrayList can hold. As elements are added to an ArrayList, 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 ArrayList.

The elements are copied onto the ArrayList in the same order they are read by the IEnumerator of the ICollection.

This constructor is an O(n) operation, where n is the number of elements in c.

See also

Applies to

ArrayList(Int32)

Initializes a new instance of the ArrayList class that is empty and has the specified initial capacity.

public:
 ArrayList(int capacity);
public ArrayList (int capacity);
new System.Collections.ArrayList : int -> System.Collections.ArrayList
Public Sub New (capacity As Integer)

Parameters

capacity
Int32

The number of elements that the new list can initially store.

Exceptions

capacity is less than zero.

Remarks

The capacity of an ArrayList is the number of elements that the ArrayList can hold. As elements are added to an ArrayList, 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 ArrayList.

This constructor is an O(n) operation, where n is capacity.

See also

Applies to