다음을 통해 공유


CollectionBase.Capacity 속성

정의

CollectionBase에 포함될 수 있는 요소의 수를 가져오거나 설정합니다.

public:
 property int Capacity { int get(); void set(int value); };
public int Capacity { get; set; }
[System.Runtime.InteropServices.ComVisible(false)]
public int Capacity { get; set; }
member this.Capacity : int with get, set
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.Capacity : int with get, set
Public Property Capacity As Integer

속성 값

CollectionBase에 포함될 수 있는 요소의 수입니다.

특성

예외

CapacityCount보다 작은 값으로 설정되어 있습니다.

시스템에 사용 가능한 메모리가 부족합니다.

설명

Capacity 는 에서 저장할 수 있는 요소의 수입니다 CollectionBase . Count 에 실제로 있는 요소의 수는 CollectionBase합니다.

Capacity 항상 보다 크거나 같음 Count합니다. 요소를 추가하는 동안 를 초과 Capacity 하면 Count 이전 요소를 복사하고 새 요소를 추가하기 전에 내부 배열을 다시 할당하여 용량이 자동으로 증가합니다.

속성을 명시적으로 설정하여 용량을 Capacity 줄일 수 있습니다. 값 Capacity 이 명시적으로 설정되면 내부 배열도 지정된 용량을 수용하도록 재할당됩니다.

이 속성의 값을 검색하는 작업은 작업입니다 O(1) . 속성 설정은 작업입니다 O(n) . 여기서 n 는 새 용량입니다.

적용 대상

추가 정보