Queue.TrimToSize Method

Definition

Namespace:

System.Collections

Assembly:

System.Collections.NonGeneric.dll

Source:

Queue.cs

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

public:
 virtual void TrimToSize();

public virtual void TrimToSize ();

abstract member TrimToSize : unit -> unit
override this.TrimToSize : unit -> unit

Public Overridable Sub TrimToSize ()

Exceptions

NotSupportedException

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.

See also

• Clear()
• Count