다음을 통해 공유


Queue<T>.TrimExcess 메서드

정의

오버로드

TrimExcess()

해당 수가 현재 용량의 90% 미만인 경우 Queue<T>실제 요소 수로 용량을 설정합니다.

TrimExcess(Int32)

Queue<T> 개체의 용량을 지정된 항목 수로 설정합니다.

TrimExcess()

Source:
Queue.cs
Source:
Queue.cs
Source:
Queue.cs

해당 수가 현재 용량의 90% 미만인 경우 Queue<T>실제 요소 수로 용량을 설정합니다.

public:
 void TrimExcess();
public void TrimExcess ();
member this.TrimExcess : unit -> unit
Public Sub TrimExcess ()

설명

컬렉션에 새 요소가 추가되지 않는 경우 이 메서드를 사용하여 컬렉션의 메모리 오버헤드를 최소화할 수 있습니다. 그러나 큰 Queue<T> 재할당 및 복사하는 데 드는 비용은 상당할 수 있으므로 목록이 용량의 90%를 초과하는 경우 TrimExcess 메서드는 아무 작업도 수행하지 않습니다. 이렇게 하면 상대적으로 적은 이득을 얻기 위해 큰 재할당 비용이 발생하지 않습니다.

이 메서드는 nCountO(n) 작업입니다.

Queue<T> 초기 상태로 다시 설정하려면 TrimExcess 메서드를 호출하기 전에 Clear 메서드를 호출합니다. 빈 Queue<T> 트리밍하면 Queue<T> 용량이 기본 용량으로 설정됩니다.

추가 정보

적용 대상

TrimExcess(Int32)

Source:
Queue.cs

Queue<T> 개체의 용량을 지정된 항목 수로 설정합니다.

public:
 void TrimExcess(int capacity);
public void TrimExcess (int capacity);
member this.TrimExcess : int -> unit
Public Sub TrimExcess (capacity As Integer)

매개 변수

capacity
Int32

새 용량입니다.

예외

전달된 용량이 항목 수보다 낮습니다.

적용 대상