Queue<T> Constructor (Int32)

Initializes a new instance of the Queue<T> class that is empty and has the specified initial capacity.

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

public Queue(
	int capacity
)

Parameters

capacity
Type: System.Int32

The initial number of elements that the Queue<T> can contain.

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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft