Share via

Recognizers.CopyTo Method

  • Article

Recognizers.CopyTo Method

Copies all of the elements of the current Recognizers collection to the specified one-dimensional array, starting at the specified destination array index.

Definition

Visual Basic .NET Public Sub CopyTo( _
ByVal array As Array, _
ByVal index As Integer _
)
C# public void CopyTo(
Array array,
int index
);
Managed C++ public: void CopyTo(
Array *array,
int *index
);

Parameters

array System.Array. The one-dimensional array that is the destination of elements copied from the collection. The array must have zero-based indexing.
index System.Int32. The zero-based index in the array parameter at which copying begins.

Remarks

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

An exception is thrown if:

  • The array parameter is a null (Nothing in Microsoft® Visual Basic® .NET) reference.
  • The index parameter is less than zero.
  • The array parameter is multidimensional.
  • The index parameter is equal to or greater than the length of the array parameter.
  • The number of elements in the collection is higher than the available space from the index parameter to the end of the destination array parameter.

The type of the collection is cast automatically to the type of the destination array parameter. However, this method only copies elements to arrays of the same type as the elements of the collection or arrays of type Object Leave Site. Attempting to copy to another type of array causes an InvalidCastException Leave Site exceptionto be thrown.

This method is synchronized.

Examples

[C#]

This C# example creates a Recognizers collection, theRecognizers, and then copies the collection into the array, theCopy, which is set to the same size as the number of members of theRecognizers.

//Create the Recognizers collection
theRecognizers = new Recognizers();
//Create the array and set the size equal to the size of the Recognizers collection
theCopy = new Recognizer[theRecognizers.Count];
//Copy the Recognizers collection into the array, starting at index of 0
theRecognizers.CopyTo(theCopy,0);

[Visual Basic .NET]

This Visual Basic .NET example creates a Recognizers collection, theRecognizers, and then copies the collection into the array, theCopy, which is set to the same size as the number of members of theRecognizers.

'Create the Recognizers Collection.
Dim theRecognizers As Recognizers
'Create the array and set the size equal to the size of the Recognizers collection.
Dim theCopy(theRecognizers.Count) As Recognizer
'Copy the Recognizers collection into the array, starting at index of 0
theRecognizers.CopyTo(theCopy, 0)