NameObjectCollectionBase.ICollection.CopyTo(Array, Int32) Method
Definition
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 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 -> unitSub CopyTo (array As Array, index As Integer) Implements ICollection.CopyToParameters
- 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.
