Queue Constructor (Int32)
Collapse the table of content
Expand the table of content

Queue Constructor (Int32)

.NET Framework 1.1

Initializes a new instance of the Queue class that is empty, has the specified initial capacity and uses the default growth factor.

[Visual Basic]
Public Sub New( _
   ByVal capacity As Integer _
public Queue(
   int capacity
public: Queue(
   int capacity
public function Queue(
   capacity : int


The initial number of elements that the Queue can contain.


Exception Type Condition
ArgumentOutOfRangeException capacity is less than zero.


The initial capacity is the starting capacity of the new Queue. The growth factor is the number by which the current capacity is multiplied when a greater capacity is required. The default initial capacity is 32 and the default growth factor is 2.0.

If the number of elements added to the Queue reaches the current capacity, the capacity is automatically increased. The new capacity is determined by multiplying the current capacity by the growth factor.

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 Queue.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

Queue Class | Queue Members | System.Collections Namespace | Queue Constructor Overload List

© 2016 Microsoft