SortedList.Capacity

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

SortedList.Capacity プロパティ

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

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

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

Visual Basic (宣言)

Public Property Capacity As
 Integer

Visual Basic (使用法)

Dim instance As SortedList(Of
 TKey, TValue)
Dim value As Integer

value = instance.Capacity

instance.Capacity = value

C#

public int Capacity { get;
 set; }

C++

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)

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

例外

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

解説

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

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

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

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

SortedList.Capacity プロパティ

SortedList の容量を取得または設定します。

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

Visual Basic (宣言)

Public Overridable Property
 Capacity As Integer

Visual Basic (使用法)

Dim instance As SortedList
Dim value As Integer

value = instance.Capacity

instance.Capacity = value

C#

public virtual int Capacity { get;
 set; }

C++

public:
virtual 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)

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

例外

例外の種類	条件
ArgumentOutOfRangeException	代入された値が、SortedList 内の現在の要素の数未満です。

解説

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

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

容量を減らすには、TrimToSize を呼び出すか、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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

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