Partilhar via


Dictionary<TKey,TValue>.ICollection.CopyTo(Array, Int32) Método

Definição

Copia os elementos do ICollection<T> para uma matriz, começando no índice da matriz especificada.

 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

A matriz unidimensional que é o destino dos elementos copiados de ICollection<T>. A matriz 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

Exceções

array é null.

index é menor que 0.

array é multidimensional.

- ou -

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

- ou -

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

- ou -

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

Comentários

Cada elemento copiado de um Dictionary<TKey,TValue> é uma KeyValuePair<TKey,TValue> estrutura que representa um valor e sua chave.

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 geram um InvalidCastException, enquanto as implementações genéricas geram um ArgumentException.

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

Aplica-se a