Collection<T>.ICollection.CopyTo(Array, Int32) 메서드

정의

특정 ICollection 인덱스부터 시작하여 Array의 요소를 Array에 복사합니다.Copies the elements of the ICollection to an Array, starting at a particular Array index.

 virtual void System.Collections.ICollection.CopyTo(Array ^ array, int index) = System::Collections::ICollection::CopyTo;
void ICollection.CopyTo (Array array, int index);

매개 변수

array
Array

Array에서 복사한 요소의 대상인 일차원 ICollection입니다.The one-dimensional Array that is the destination of the elements copied from ICollection. Array에는 0부터 시작하는 인덱스가 있어야 합니다.The Array must have zero-based indexing.

index
Int32

array에서 복사가 시작되는 0부터 시작하는 인덱스입니다.The zero-based index in array at which copying begins.

구현

예외

arraynull인 경우array is null.

index가 0보다 작습니다.index is less than zero.

array가 다차원 배열인 경우array is multidimensional.

또는-or- array에 0부터 시작하는 인덱스가 없습니다.array does not have zero-based indexing.

또는-or- 소스 ICollection의 요소 수가 대상 arrayindex부터 끝까지 사용 가능한 공간보다 큽니다.The number of elements in the source ICollection is greater than the available space from index to the end of the destination array.

또는-or- 소스 ICollection의 형식을 대상 array의 형식으로 자동 캐스팅할 수 없습니다.The type of the source ICollection cannot be cast automatically to the type of the destination array.

설명

참고

경우는 원본의 유형을 ICollection 대상의 형식으로 자동 캐스팅할 수 없는 array, 제네릭이 아닌 구현은 ICollection.CopyTo throw InvalidCastException제네릭 구현은 throw 하는 반면, ArgumentException합니다.If the type of the source ICollection cannot be cast automatically to the type of the destination array, the non-generic implementations of ICollection.CopyTo throw InvalidCastException, whereas the generic implementations throw ArgumentException.

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

적용 대상