Udostępnij za pośrednictwem


TableCellCollection.Capacity Właściwość

Definicja

Pobiera lub ustawia pojemność elementu kolekcji wstępnie alokowanej dla tej kolekcji.

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

Pojemność elementu kolekcji wstępnie alokowanej dla tej kolekcji. Wartość domyślna to 8.

Wyjątki

Zgłaszane, gdy zostanie podjęta próba ustawienia Capacity wartości mniejszej niż bieżąca wartość .Count

Uwagi

Właściwość Capacity reprezentuje liczbę wstępnie przydzielonych miejsc do przechowywania elementów w tej kolekcji, natomiast Count właściwość reprezentuje rzeczywistą liczbę elementów znajdujących się obecnie w kolekcji. Wartość parametru Capacity jest zawsze co najmniej tak duża, jak wartość .Count

Gdy nowo dodane elementy kolekcji powodują przekroczenie pojemności kolekcji, pojemność jest zwiększana automatycznie w celu uwzględnienia nowo dodanych elementów kolekcji. Zwiększenie pojemności kolekcji obejmuje przydzielanie dodatkowych miejsc kolekcji, co wiąże się zarówno z obciążeniem wydajnością, jak i pamięcią. Capacity Użyj właściwości , aby zoptymalizować pojemność kolekcji w przypadkach, gdy łączna lub maksymalna liczba elementów kolekcji jest znana z wyprzedzeniem. TrimToSize Użyj metody , aby spowodować wyrównanie pojemności kolekcji z bieżącą liczbą kolekcji.

Dotyczy