Dictionary<TKey,TValue>.ICollection.CopyTo(Array, Int32) 方法

定義

命名空間:

System.Collections.Generic

組件:

System.Collections.dll

來源:

Dictionary.cs

從指定的陣列索引處開始，將 ICollection<T> 的項目複製到陣列。

 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

一維陣列，是從 ICollection<T> 複製過來之項目的目的端。 陣列必須有以零為起始的索引。

index

Int32

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

實作

CopyTo(Array, Int32)

例外狀況

ArgumentNullException

array 為 null。

ArgumentOutOfRangeException

index 小於 0。

ArgumentException

array 是多維的。

-或-

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

-或-

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

-或-

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

備註

從 Dictionary<TKey,TValue> 複製的每個元素都是代表 KeyValuePair<TKey,TValue> 值及其索引鍵的結構。

注意

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

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