CollectionBase.Capacity Właściwość

Definicja

Przestrzeń nazw:

System.Collections

Zestaw:

System.Collections.NonGeneric.dll

Źródło:

CollectionBase.cs

Pobiera lub ustawia liczbę elementów, które CollectionBase mogą zawierać.

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

Wartość właściwości

Int32

Liczba elementów, które CollectionBase mogą zawierać.

Wyjątki

ArgumentOutOfRangeException

Capacity jest ustawiona na wartość mniejszą niż Count.

OutOfMemoryException

W systemie jest za mało pamięci.

Uwagi

Capacity jest liczbą elementów, które CollectionBase mogą przechowywać. Count jest liczbą elementów, które faktycznie znajdują się w obiekcie CollectionBase.

Capacity wartość jest zawsze większa niż lub równa Count. W przypadku Count przekroczenia limitu Capacity podczas dodawania elementów pojemność jest automatycznie zwiększana przez przeniesienie tablicy wewnętrznej przed skopiowaniem starych elementów i dodaniem nowych elementów.

Pojemność można zmniejszyć, ustawiając Capacity jawnie właściwość. Gdy wartość jest Capacity ustawiana jawnie, tablica wewnętrzna jest również ponownie przydzielana, aby pomieścić określoną pojemność.

Pobieranie wartości tej właściwości jest operacją O(1) ; ustawienie właściwości jest operacją O(n) , gdzie n jest nową pojemnością.

Zobacz też

• Count