Compartir a través de

  • Artículo

Stack<T> Constructor (Int32)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public Sub New ( _
    capacity As Integer _
)

public Stack(
    int capacity
)

Parameters

Exceptions

Exception Condition
ArgumentOutOfRangeException

capacity is less than zero.

Remarks

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

The capacity can be decreased by calling TrimExcess.

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

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.