StringCollection.IList.Insert(Int32, Object) 메서드

정의

StringCollection의 지정된 인덱스에 요소를 삽입합니다.Inserts an element into the StringCollection at the specified index.

 virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
Sub Insert (index As Integer, value As Object) Implements IList.Insert

매개 변수

index
Int32

value을 삽입해야 하는 인덱스(0부터 시작)입니다.The zero-based index at which value should be inserted.

value
Object

삽입할 Object입니다.The Object to insert. 값은 null이 될 수 있습니다.The value can be null.

구현

예외

index가 0보다 작은 경우index is less than zero.

-또는--or- indexCount보다 큰 경우index is greater than Count.

StringCollection이 읽기 전용인 경우The StringCollection is read-only.

-또는--or- StringCollection가 고정 크기입니다.The StringCollection has a fixed size.

설명

Count 이미 용량과 같은 경우 내부 배열을 자동으로 재할당 하 여 StringCollection 용량이 늘어나고, 새 요소가 추가 되기 전에 기존 요소가 새 배열에 복사 됩니다.If Count already equals the capacity, the capacity of the StringCollection is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added.

하는 경우 index 값과 같음 Countvalue 끝에 추가 됩니다 StringCollection합니다.If index is equal to Count, value is added to the end of StringCollection.

목록처럼 연속된 요소로 구성된 컬렉션에서는 삽입 지점 다음에 있는 요소를 아래로 이동하여 새 요소로 적용합니다.In collections of contiguous elements, such as lists, the elements that follow the insertion point move down to accommodate the new element. 컬렉션에 인덱스가 지정된 경우 이동되는 요소의 인덱스도 업데이트됩니다.If the collection is indexed, the indexes of the elements that are moved are also updated. 요소가 해시 테이블 같은 버킷으로 개념적으로 그룹화되어 있는 컬렉션에는 이러한 동작이 적용되지 않습니다.This behavior does not apply to collections where elements are conceptually grouped into buckets, such as a hash table.

이 메서드는 O (n) 작업, 여기서 nCount합니다.This method is an O(n) operation, where n is Count.

적용 대상

추가 정보