Udostępnij za pośrednictwem


CollectionBase.Capacity Właściwość

Definicja

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; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }
member this.Capacity : int with get, set
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Capacity : int with get, set
Public Property Capacity As Integer

Wartość właściwości

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

Atrybuty

Wyjątki

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

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ż