CollectionBase.Capacity Properti

Definisi

Ruang nama:

System.Collections

Rakitan:

System.Collections.NonGeneric.dll

Sumber:

CollectionBase.cs

Mendapatkan atau mengatur jumlah elemen yang dapat dimuat CollectionBase .

public:
 property int Capacity { int get(); void set(int value); };

public int Capacity { get; set; }

member this.Capacity : int with get, set

Public Property Capacity As Integer

Nilai Properti

Int32

Jumlah elemen yang dapat dimuat CollectionBase .

Pengecualian

ArgumentOutOfRangeException

Capacity diatur ke nilai yang kurang dari Count.

OutOfMemoryException

Tidak tersedia cukup memori pada sistem.

Keterangan

Capacity adalah jumlah elemen yang CollectionBase dapat disimpan. Count adalah jumlah elemen yang sebenarnya ada di CollectionBase.

Capacity selalu lebih besar dari atau sama dengan Count. Jika Count melebihi Capacity saat menambahkan elemen, kapasitas secara otomatis ditingkatkan dengan merealokasi array internal sebelum menyalin elemen lama dan menambahkan elemen baru.

Kapasitas dapat dikurangi dengan mengatur Capacity properti secara eksplisit. Ketika nilai Capacity diatur secara eksplisit, array internal juga dialokasikan untuk mengakomodasi kapasitas yang ditentukan.

Mengambil nilai properti ini adalah O(1) operasi; mengatur properti adalah O(n) operasi, di mana n adalah kapasitas baru.

Lihat juga

• Count