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

定義

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

C#
void ICollection.CopyTo (Array array, int index);

參數

array
Array

一維 Array,是從 ICollection 複製過來之項目的目的端。 Array 必須有以零為起始的索引。

index
Int32

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

實作

例外狀況

arraynull

index 小於零。

array 是多維的。

-或-

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

-或-

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

-或-

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

備註

注意

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

這個方法是 O (n) 作業,其中 nCount

適用於

產品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0