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

매개 변수

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.

구현

예외

array이(가) null인 경우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의 제네릭이 아닌 구현은 InvalidCastException를 throw 하는 반면 제네릭 구현은 ArgumentException을 throw 합니다.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.

적용 대상