CollectionBase.Capacity プロパティ

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

CollectionBase.Capacity プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

CollectionBase に格納できる要素の数を取得または設定します。

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Property Capacity As
 Integer

Visual Basic (使用法)

Dim instance As CollectionBase
Dim value As Integer

value = instance.Capacity

instance.Capacity = value

C#

[ComVisibleAttribute(false)] 
public int Capacity { get;
 set; }

C++

[ComVisibleAttribute(false)] 
public:
property int Capacity {
    int get ();
    void set (int value);
}

J#

/** @property */
public int get_Capacity ()

/** @property */
public void set_Capacity (int
 value)

JScript

public function get Capacity
 () : int

public function set Capacity
 (value : int)

プロパティ値
CollectionBase に格納できる要素の数。

例外

例外の種類	条件
ArgumentOutOfRangeException	Capacity が Count より小さい値に設定されています。

解説

Capacity は、CollectionBase に格納できる要素の数です。Count は、CollectionBase に実際に格納されている要素の数です。

Capacity は、常に Count 以上です。要素を追加しているときに Count が Capacity を超えた場合は、古い要素をコピーして新しい要素を追加する前に、内部配列を再割り当てすることによって、リストの容量が自動的に増加します。

容量を減らす場合は、Capacity プロパティを明示的に設定します。Capacity の値を明示的に設定すると、指定した容量が有効になるように、内部配列も再割り当てされます。

このプロパティ値を取得することは、O(1) 操作になります。また、このプロパティを設定することは O(n) 操作になります (n は新しい容量)。

プラットフォーム

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

参照

関連項目
CollectionBase クラス
CollectionBase メンバ
System.Collections 名前空間
Count