TableRowCollection.Capacity TableRowCollection.Capacity TableRowCollection.Capacity TableRowCollection.Capacity Property

정의

이 컬렉션에 미리 할당된 컬렉션 항목 용량을 가져오거나 설정합니다.Gets or sets the pre-allocated collection item capacity for this collection.

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

속성 값

이 컬렉션에 미리 할당된 컬렉션 항목 용량입니다.The pre-allocated collection item capacity for this collection. 기본값은 8합니다.The default value is 8.

예외

CapacityCount의 현재 값보다 작은 값으로 설정하려고 시도하는 경우 발생합니다.Raised when an attempt is made to set Capacity to a value that is less than the current value of Count.

설명

합니다 Capacity 반면 속성이이 컬렉션에서 항목을 저장 하는 것에 대 한 미리 할당 된 슬롯 수를 나타내는 Count 속성 컬렉션의 현재 항목의 실제 수를 나타냅니다.The Capacity property represents the number of pre-allocated slots for storing items in this collection, whereas the Count property represents the actual number of items currently in the collection. 변수의 Capacity 은 값 이상이 항상 Count합니다.The value of Capacity is always at least as large as the value of Count.

새로 추가 된 컬렉션 항목 컬렉션 용량에 용량을 초과 하는 컬렉션 수를 발생 하는 경우 새로 추가 된 컬렉션 항목에 맞게 자동으로 증가 됩니다.When newly added collection items cause the collection count to exceed the collection capacity, the capacity is automatically increased to accommodate the newly added collection items. 수집 용량을 늘리는 성능 및 메모리 오버 헤드를 유발 하는 추가 컬렉션 슬롯을 할당 해야 합니다.Increasing the collection capacity involves allocating additional collection slots, which incurs both performance and memory overhead. 사용 된 Capacity 컬렉션 항목의 총합 또는 최대값이 수를 미리 알고 있는 경우 수집 용량을 최적화 하는 속성입니다.Use the Capacity property to optimize the collection capacity in cases where the total or maximum number of collection items is known in advance. 사용 된 TrimToSize 수집 용량을 현재 컬렉션 수와 같게 하려면 하는 방법입니다.Use the TrimToSize method to cause the collection capacity to equalized with the current collection count.

적용 대상

추가 정보