List<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 arrayIndex) = System::Collections::ICollection::CopyTo;
void ICollection.CopyTo (Array array, int arrayIndex);
abstract member System.Collections.ICollection.CopyTo : Array * int -> unit
override this.System.Collections.ICollection.CopyTo : Array * int -> unit
Sub CopyTo (array As Array, arrayIndex As Integer) Implements ICollection.CopyTo

매개 변수

array
Array

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

arrayIndex
Int32

array에서 복사를 시작할 인덱스(0부터 시작)입니다.The zero-based index in array at which copying begins.

구현

예외

arraynull입니다.array is null.

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

array는 다차원입니다.array is multidimensional.

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

또는-or- 소스 ICollection의 요소 수가 대상 arrayIndexarray부터 끝까지 사용 가능한 공간보다 큽니다.The number of elements in the source ICollection is greater than the available space from arrayIndex 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의 제네릭이 아닌 구현이 InvalidCastExceptionthrow 하는 반면, 제네릭 구현은 ArgumentException을 throw 합니다.If the type of the source ICollection cannot be cast automatically to the type of the destination array, the nongeneric 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.

적용 대상