다음을 통해 공유


TableRowGroupCollection.Capacity 속성

정의

이 컬렉션에 미리 할당된 컬렉션 항목 용량을 가져오거나 설정합니다.

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

속성 값

Int32

이 컬렉션에 미리 할당된 컬렉션 항목 용량입니다. 기본값은 8 입니다.

예외

CapacityCount의 현재 값보다 작은 값으로 설정하려고 시도하는 경우 발생합니다.

설명

합니다 Capacity 반면 속성이이 컬렉션에서 항목을 저장 하는 것에 대 한 미리 할당 된 슬롯 수를 나타내는 Count 속성 컬렉션의 현재 항목의 실제 수를 나타냅니다. 변수의 Capacity 은 값 이상이 항상 Count합니다.

새로 추가 된 컬렉션 항목 컬렉션 용량에 용량을 초과 하는 컬렉션 수를 발생 하는 경우 새로 추가 된 컬렉션 항목에 맞게 자동으로 증가 됩니다. 수집 용량을 늘리는 성능 및 메모리 오버 헤드를 유발 하는 추가 컬렉션 슬롯을 할당 해야 합니다. 사용 된 Capacity 컬렉션 항목의 총합 또는 최대값이 수를 미리 알고 있는 경우 수집 용량을 최적화 하는 속성입니다. 사용 된 TrimToSize 수집 용량을 현재 컬렉션 수와 같게 하려면 하는 방법입니다.

적용 대상

추가 정보