Udostępnij za pośrednictwem


TableRowCollection.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

Pojemność wstępnie przydzielonych elementów kolekcji 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 automatycznie zwiększana 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

Zobacz też