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

Definição

Namespace:

Microsoft.VisualBasic

Assembly:

Microsoft.VisualBasic.dll

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

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

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

abstract member ICollectionCopyTo : Array * int -> unit
override this.ICollectionCopyTo : Array * int -> unit

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

Parâmetros

array

Array

O Array unidimensional que é o destino dos elementos copiados do objeto Collection. 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.

Exceções

ArgumentNullException

array é null.

ArgumentOutOfRangeException

index é menor que zero.

ArgumentException

array é multidimensional.

- ou -

O número de elementos no objeto de origem Collection é maior do que o espaço disponível de index até o final do array de destino.

InvalidCastException

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

Comentários

Os elementos são copiados para o Array na mesma ordem em que o enumerador itera por meio do Collection objeto .

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

Confira também

• Collection
• ICollection
• CopyTo(Array, Int32)
• Array