TableCellCollection.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 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, setPublic Property Capacity As IntegerWartość właściwości
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.