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

定义

从指定的数组索引开始,将 ICollection<T> 中的元素复制到一个数组中。

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

参数

array
Array

一维数组,用作从 ICollection<T> 复制的元素的目标位置。 该数组的索引必须从零开始。

index
Int32

array 中从零开始的索引,从此处开始复制。

实现

例外

arraynull

index 小于 0。

array 是多维的。

array 没有从零开始的索引。

ICollection<T> 中的元素个数大于从 index 到目标 array 末尾之间的可用空间。

无法自动将源 ICollection<T> 的类型转换为目标 array 的类型。

注解

Dictionary<TKey,TValue> 复制的每个元素都是一个 KeyValuePair<TKey,TValue> 结构,表示值及其键。

备注

如果源 ICollection 的类型无法自动强制转换为目标 array的类型,则 的非 ICollection.CopyTo 泛型实现将引发 InvalidCastException,而泛型实现将引发 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.6, 2.0, 2.1
UWP 10.0