Queue<T> Constructor (Int32)
Initializes a new instance of the Queue<T> class that is empty and has the specified initial capacity.
Assembly: System (in System.dll)
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | capacity is less than zero. |
The capacity of a Queue<T> is the number of elements that the Queue<T> can hold. As elements are added to a Queue<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 Queue<T>.
The capacity can be decreased by calling TrimExcess.
This constructor is an O(n) operation, where n is capacity.
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1