Queue Constructor (Int32)
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 );
- The initial number of elements that the Queue can contain.
|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