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

Definição

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Origem:

List.cs

Copia os elementos do ICollection para um Array, começando em um determinado índice Array.

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

void ICollection.CopyTo (Array array, int arrayIndex);

abstract member System.Collections.ICollection.CopyTo : Array * int -> unit
override this.System.Collections.ICollection.CopyTo : Array * int -> unit

Sub CopyTo (array As Array, arrayIndex As Integer) Implements ICollection.CopyTo

Parâmetros

array

Array

O Array unidimensional que é o destino dos elementos copiados de ICollection. O Array deve ter indexação com base em zero.

arrayIndex

Int32

O índice com base em zero em array no qual a cópia começa.

Implementações

CopyTo(Array, Int32)

Exceções

ArgumentNullException

array é null.

ArgumentOutOfRangeException

arrayIndex é menor que 0.

ArgumentException

array é multidimensional.

- ou -

O array não tem indexação baseada em zero.

- ou -

O número de elementos na origem ICollection é maior do que o espaço disponível de arrayIndex até o final do array de destino.

- ou -

O tipo do ICollection de origem não pode ser automaticamente convertido para o tipo de array de destino.

Comentários

Observação

Se o tipo da origem ICollection não puder ser convertido automaticamente para o tipo de destino array, as implementações não genéricas de ICollection.CopyTo throw InvalidCastException, enquanto as implementações genéricas gerarão ArgumentException.

Esse método é uma operação O(n), em que n é Count.