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ć.

C#

public int Capacity { get; set; }

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ą.

Dotyczy

Zobacz też

• Count