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


指定した配列インデックスを開始位置として、配列に ICollection<T> の要素をコピーします。Copies the elements of the ICollection<T> to an array, starting at the specified array index.

 virtual void System.Collections.ICollection.CopyTo(Array ^ array, int index) = System::Collections::ICollection::CopyTo;
void ICollection.CopyTo (Array array, int index);


Array Array

ICollection<T> から要素がコピーされる 1 次元の配列。The one-dimensional array that is the destination of the elements copied from ICollection<T>. 配列には、0 から始まるインデックスが設定されている必要があります。The array must have zero-based indexing.

Int32 Int32

コピーの開始位置とする array のインデックス (0 から始まる)。The zero-based index in array at which copying begins.



arraynull です。array is null.

index が 0 未満です。index is less than 0.

array が多次元です。array is multidimensional.

- または --or- array には、0 から始まるインデックス番号がありません。array does not have zero-based indexing.

- または --or- コピー元の ICollection<T> の要素数が、コピー先 arrayindex から最後までの使用可能領域を超えています。The number of elements in the source ICollection<T> is greater than the available space from index to the end of the destination array.

- または --or- コピー元の ICollection<T> の型をコピー先の array の型に自動的にキャストすることはできません。The type of the source ICollection<T> cannot be cast automatically to the type of the destination array.


コピーされた各要素をDictionary<TKey,TValue>は、KeyValuePair<TKey,TValue>値とそのキーを表す構造体。Each element copied from a Dictionary<TKey,TValue> is a KeyValuePair<TKey,TValue> structure representing a value and its key.


場合、ソースの種類ICollection変換先の型に自動的にキャストすることはできませんarrayの非ジェネリック実装ICollection.CopyToスロー、 InvalidCastException、汎用の実装をスロー、ArgumentExceptionします。If the type of the source ICollection cannot be cast automatically to the type of the destination array, the nongeneric implementations of ICollection.CopyTo throw an InvalidCastException, whereas the generic implementations throw an ArgumentException.

このメソッドは O (n) 操作、nCountします。This method is an O(n) operation, where n is Count.