NameObjectCollectionBase.ICollection.CopyTo(Array, Int32) Method

Definition

Copies the entire NameObjectCollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array.

 virtual void System.Collections.ICollection.CopyTo(Array ^ array, int index) = System::Collections::ICollection::CopyTo;
void ICollection.CopyTo (Array array, int index);
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

Parameters

array
Array

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

index
Int32

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

Implements

Exceptions

array is null.

index is less than zero.

array is multidimensional.

-or-

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

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

Remarks

The specified array must be of a compatible type.

This method uses Array.Copy to copy the elements.

While the ICollection.CopyTo method is not visible to COM clients by default, inheriting the NameObjectCollectionBase class can expose it and can cause undesirable behavior in COM clients.

This method is an O(n) operation, where n is Count.

Applies to