CollectionBase.Capacity Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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
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ą.