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

定义

从特定的 ICollection 索引开始,将 Array 的元素复制到一个 Array 中。Copies the elements of the ICollection to an Array, starting at a particular Array index.

 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

一维 Array,它是从 ICollection 复制的元素的目标。The one-dimensional Array that is the destination of the elements copied from ICollection. Array 必须具有从零开始的索引。The Array must have zero-based indexing.

index
Int32

array 中从零开始的索引,从此处开始复制。The zero-based index in array at which copying begins.

实现

例外

arraynullarray is null.

index 小于零。index is less than zero.

array 是多维的。array is multidimensional.

- 或 --or- array 没有从零开始的索引。array does not have zero-based indexing.

- 或 --or- ICollection 中的元素个数大于从 index 到目标 array 末尾之间的可用空间。The number of elements in the source ICollection is greater than the available space from index to the end of the destination array.

- 或 --or- 无法自动将源 ICollection 的类型转换为目标 array 的类型。The type of the source ICollection cannot be cast automatically to the type of the destination array.

注解

备注

如果源的类型 ICollection 不能自动强制转换为目标的类型 array ,则引发的非泛型实现 ICollection.CopyTo InvalidCastException ,而泛型实现将引发 ArgumentExceptionIf the type of the source ICollection cannot be cast automatically to the type of the destination array, the non-generic implementations of ICollection.CopyTo throw InvalidCastException, whereas the generic implementations throw ArgumentException.

此方法是 O (n) 操作,其中 nCountThis method is an O(n) operation, where n is Count.

适用于

另请参阅