Collection.ICollection.CopyTo(Array, Int32) Method

Reference

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.dll

Source:: Collection.vb

Source:: Collection.vb

Source:: Collection.vb

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Copies the elements of the Collection to an Array, starting at a particular Array index.

 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

Parameters

array: Array

The one-dimensional Array that is the destination of the elements copied from Collection object. The Array must have zero-based indexing.

index: Int32

The zero-based index in array at which copying begins.

Exceptions

ArgumentNullException

array is null.

ArgumentOutOfRangeException

index is less than zero.

ArgumentException

array is multidimensional.

-or-

The number of elements in the source Collection object is greater than the available space from index to the end of the destination array.

InvalidCastException

The type of the source Collection object cannot be cast automatically to the type of the destination array.

Remarks

The elements are copied to the Array in the same order in which the enumerator iterates through the Collection object.

This method is an O(n) operation, where n is obtained from the ICollection.Count.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via