TableRowGroupCollection.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 wstępnie przydzieloną pojemność elementu kolekcji 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ść wstępnie przydzielonego elementu kolekcji dla tej kolekcji. Wartość domyślna to 8.
Wyjątki
Podniesiono, gdy podjęto próbę ustawienia Capacity wartości, która jest mniejsza 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 tak duża, jak wartość .Count
Gdy nowo dodane elementy kolekcji powodują przekroczenie pojemności kolekcji, pojemność zostanie automatycznie zwiększona, aby uwzględnić nowo dodane elementy 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. Użyj właściwości , Capacity 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.