Freigeben über


Recognizers.CopyTo-Methode

Kopiert alle Elemente der aktuellen Recognizers-Auflistung in das angegebene eindimensionale Array, wobei am angegebenen Index des Zielarrays begonnen wird.

Namespace:  Microsoft.Ink
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Sub CopyTo ( _
    array As Array, _
    index As Integer _
)
'Usage
Dim instance As Recognizers
Dim array As Array
Dim index As Integer

instance.CopyTo(array, index)
public void CopyTo(
    Array array,
    int index
)
public:
virtual void CopyTo(
    Array^ array, 
    int index
) sealed
public final void CopyTo(
    Array array,
    int index
)
public final function CopyTo(
    array : Array, 
    index : int
)

Parameter

  • array
    Typ: System.Array
    Das eindimensionale Array, das das Ziel der aus der Auflistung kopierten Elemente ist. Das Array muss nullbasierte Indizierung haben.
  • index
    Typ: System.Int32
    Der nullbasierte Index im array-Parameter, an dem der Kopiervorgang beginnt.

Implementiert

ICollection.CopyTo(Array, Int32)

Hinweise

Die Elemente werden in derselben Reihenfolge in das Array-Objekt kopiert, in der der Enumerator die Recognizers durchläuft.

Im folgenden Fall wird eine Ausnahme ausgelöst:

  • Der array-Parameter ist ein nullNULL-Verweis (Nothing in Visual Basic)-Verweis (Nothing in Microsoft® Visual Basic® .NET).

  • Der index-Parameter ist kleiner als 0 (null).

  • Der array-Parameter ist mehrdimensional.

  • Der index-Parameter ist größer oder gleich der Länge des array-Parameters.

  • Die Anzahl der Elemente in der Auflistung überschreitet den verfügbaren Platz vom index-Parameter bis zum Ende des Ziel-array-Parameters.

Der Typ der Auflistung wird automatisch in den Typ des Ziel-array-Parameters umgewandelt. Mit dieser Methode werden Elemente jedoch nur in Arrays kopiert, die denselben Typ wie die Elemente der Auflistung aufweisen, oder in Arrays vom Typ Object. Beim Versuch, in einen anderen Typ von Array zu kopieren, wird eine InvalidCastException-Ausnahme ausgelöst.

Diese Methode ist synchronisiert.

Beispiele

In diesem C#-Beispiel wird eine Recognizers-Auflistung namens theRecognizers erstellt und dann in ein Array namens theCopy kopiert, das auf dieselbe Größe wie die Anzahl der Member von theRecognizers festgelegt wird.

//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);

In diesem Visual Basic .NET-Beispiel wird eine Recognizers-Auflistung namens theRecognizers erstellt und dann in ein Array namens theCopy kopiert, das auf dieselbe Größe wie die Anzahl der Member von theRecognizers festgelegt wird.

'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)

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Versionsinformationen

.NET Framework

Unterstützt in: 3.0

Siehe auch

Referenz

Recognizers-Klasse

Recognizers-Member

Microsoft.Ink-Namespace