Collection<T>.ICollection.CopyTo Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Copies the elements of the ICollection to an Array, starting at a particular Array index.
Namespace: System.Collections.ObjectModel
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Private Sub CopyTo ( _
array As Array, _
index As Integer _
) Implements ICollection.CopyTo
void ICollection.CopyTo(
Array array,
int index
)
Parameters
- array
Type: System.Array
The one-dimensional Array that is the destination of the elements copied from ICollection. The Array must have zero-based indexing.
- index
Type: System.Int32
The zero-based index in array at which copying begins.
Implements
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | array is nulla null reference (Nothing in Visual Basic). |
| ArgumentOutOfRangeException | index is less than zero. |
| ArgumentException | array is multidimensional. -or- array does not have zero-based indexing. -or- The number of elements in the source ICollection is greater than the available space from index to the end of the destination array. -or- The type of the source ICollection cannot be cast automatically to the type of the destination array. |
Remarks
.gif "Note") Note: |
|---|
If the type of the source ICollection cannot be cast automatically to the type of the destination array, the non-generic implementations of ICollection.CopyTo throw InvalidCastException, whereas the generic implementations throw ArgumentException. |
This method is an O(n) operation, where n is Count.
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.