Queue.TrimExcess メソッド

.NET Framework クラス ライブラリ リファレンス

Queue.TrimExcess メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

Queue 内にある実際の要素数が現在の容量の 90% 未満の場合は、容量をその数に設定します。

名前空間: System.Collections.Generic
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub TrimExcess

Visual Basic (使用法)

Dim instance As Queue(Of
 T)

instance.TrimExcess

C#

public void TrimExcess ()

C++

public:
void TrimExcess ()

J#

public void TrimExcess ()

JScript

public function TrimExcess ()

解説

今後コレクションに要素が追加されないことがわかっている場合は、このメソッドを使用して、コレクションのメモリ オーバーヘッドを最小化できます。ただし、大きな Queue の再割り当ておよびコピーのコストを無視できなくなる可能性があるため、リストが容量の 90% を超えている場合、TrimExcess メソッドは何も実行しません。これにより、比較的小さな効果のために大きな再割り当てコストが発生することを防ぎます。

このメソッドは O(n) 操作です。ここで、n は Count です。

Queue を初期状態にリセットするには、TrimExcess メソッドの前に、Clear メソッドを呼び出します。空の Queue をトリムすると、Queue の容量は既定値に設定されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Queue ジェネリック クラス
Queue メンバ
System.Collections.Generic 名前空間
Queue.Clear メソッド
Count