List<T>.ICollection.CopyTo(Array, Int32) List<T>.ICollection.CopyTo(Array, Int32) Method

定義

從特定的 ICollection 索引開始,將 Array 的項目複製到 ArrayCopies 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);

參數

array
Array Array

一維 Array,是從 ICollection 複製過來之項目的目的端。The one-dimensional Array that is the destination of the elements copied from ICollection. Array 必須有以零為起始的索引。The Array must have zero-based indexing.

arrayIndex
Int32 Int32

array 中以零起始的索引,即開始複製的位置。The zero-based index in array at which copying begins.

實作

例外狀況

arraynullarray is null.

arrayIndex 小於 0。arrayIndex is less than 0.

array 是多維的。array is multidimensional.

-或--or- array 沒有以零起始的索引。array does not have zero-based indexing.

-或--or- 來源 ICollection 中的項目數目,大於 arrayIndex 到目的 array 結尾的可用空間。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擲回InvalidCastException,而泛型實作擲回ArgumentExceptionIf 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) 運算,其中nCountThis method is an O(n) operation, where n is Count.

適用於