Export (0) Print
Expand All

Stack Constructor (Int32)

Initializes a new instance of the Stack class that is empty and has the specified initial capacity or the default initial capacity, whichever is greater.

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

public Stack(
	int initialCapacity
)

Parameters

initialCapacity
Type: System.Int32

The initial number of elements that the Stack can contain.

ExceptionCondition
ArgumentOutOfRangeException

initialCapacity is less than zero.

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

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

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show:
© 2015 Microsoft