Queue.TrimToSize Method

Definition

Sets the capacity to the actual number of elements in the Queue.

C#
public virtual void TrimToSize();

Exceptions

The Queue is read-only.

Remarks

This method can be used to minimize a queue's memory overhead if no new elements will be added to the queue.

To reset a Queue to its initial state, call the Clear method before calling TrimToSize. Trimming an empty Queue sets the capacity of the Queue to the default capacity.

This method is an O(n) operation, where n is Count.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0

See also