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 _
)
[C#]
public Queue(
   int capacity
);
[C++]
public: Queue(
   int capacity
);
[JScript]
public function Queue(
   capacity : int
);

Parameters

capacity
The initial number of elements that the Queue can contain.

Exceptions

Exception Type Condition
ArgumentOutOfRangeException capacity is less than zero.

Remarks

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.

Requirements

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

Show:
© 2016 Microsoft