Udostępnij za pośrednictwem


TableRowGroupCollection.Capacity Właściwość

Definicja

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, set
Public Property Capacity As Integer

Wartość właściwości

Int32

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.

Dotyczy

Zobacz też