Queue.TrimToSize Method

Definition

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

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

See also