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

定義

命名空間:

System.Collections.Generic

組件:

System.Collections.dll

來源:

List.cs

從特定的 ICollection 索引開始，將 Array 的項目複製到 Array。

 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，是從 ICollection 複製過來之項目的目的端。 Array 必須有以零為起始的索引。

arrayIndex

Int32

array 中以零起始的索引，即開始複製的位置。

實作

CopyTo(Array, Int32)

例外狀況

ArgumentNullException

array 為 null。

ArgumentOutOfRangeException

arrayIndex 小於 0。

ArgumentException

array 是多維的。

-或-

array 沒有以零為起始的索引。

-或-

來源 ICollection 中的項目數大於 arrayIndex 到目的 array 結尾的可用空間。

-或-

來源 ICollection 的類型無法自動轉換成目的 array 的類型。

備註

注意

如果來源 ICollection 的類型無法自動轉換成目的地 array 的類型，則會擲回 的非一般實 ICollection.CopyToInvalidCastException 作，而泛型實作則會擲回 ArgumentException 。

這個方法是 o (n) 作業，其中 n 是 Count 。