Collection<T>.ICollection.CopyTo(Array, Int32) Método

Definição

Copia os elementos do ICollection para um Array, começando em um determinado índice 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

Parâmetros

array
Array

O Array unidimensional que é o destino dos elementos copiados de ICollection.The one-dimensional Array that is the destination of the elements copied from ICollection. O Array deve ter indexação com base em zero.The Array must have zero-based indexing.

index
Int32

O índice com base em zero em array no qual a cópia começa.The zero-based index in array at which copying begins.

Implementações

Exceções

array é null.array is null.

index é menor que zero.index is less than zero.

array é multidimensional.array is multidimensional.

- ou --or- O array não tem indexação baseada em zero.array does not have zero-based indexing.

- ou --or- O número de elementos na origem ICollection é maior do que o espaço disponível de index até o final do array de destino.The number of elements in the source ICollection is greater than the available space from index to the end of the destination array.

- ou --or- O tipo do ICollection de origem não pode ser automaticamente convertido para o tipo de array de destino.The type of the source ICollection cannot be cast automatically to the type of the destination array.

Comentários

Observação

Se o tipo da origem ICollection não puder ser convertido automaticamente no tipo do destino array , as implementações não genéricas de ICollection.CopyTo throw InvalidCastException , enquanto as implementações genéricas serão lançadas ArgumentException .If 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.

Este método é uma operação O(n), em que n é Count.This method is an O(n) operation, where n is Count.

Aplica-se a