다음을 통해 공유


ArrayList.Capacity 속성

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

네임스페이스: System.Collections
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
Public Overridable Property Capacity As Integer
‘사용 방법
Dim instance As ArrayList
Dim value As Integer

value = instance.Capacity

instance.Capacity = value
public virtual int Capacity { get; set; }
public:
virtual property int Capacity {
    int get ();
    void set (int value);
}
/** @property */
public int get_Capacity ()

/** @property */
public void set_Capacity (int value)
public function get Capacity () : int

public function set Capacity (value : int)

속성 값

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

예외

예외 형식 조건

ArgumentOutOfRangeException

CapacityCount보다 작은 값으로 설정된 경우

설명

CapacityArrayList에 저장될 수 있는 요소의 수입니다. CountArrayList에 실제로 저장되어 있는 요소의 수입니다.

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

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

이 속성 값을 검색하는 것은 O(1) 연산이며 속성을 설정하는 것은 O(n) 연산입니다. 여기서 n은 새 용량입니다.

플랫폼

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

.NET Compact Framework

2.0, 1.0에서 지원

참고 항목

참조

ArrayList 클래스
ArrayList 멤버
System.Collections 네임스페이스
Count