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 índice Array específico.

 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 unidimensional Array que é o destino dos elementos copiados do Collection objeto. O Array deve ter indexação baseada em zero.

index
Int32

O índice baseado em zero no array 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 até index o final do destino array.

InvalidCastException

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

Comentários

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

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

Aplica-se a

Confira também