Dictionary<TKey,TValue>.ValueCollection.ICollection.CopyTo Método

Definição

Namespace:

System.Collections.Generic

Assembly:

System.Collections.dll

Origem:

Dictionary.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 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. O Array deve ter indexação com base em zero.

index

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

index é menor que zero.

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 index 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 do destino array, as implementações não genéricas de ICollection.CopyTo throw InvalidCastException, enquanto as implementações genéricas gerarão ArgumentException.

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

Confira também

• ICollection
• Array