Metodo Cursors.CopyTo

Articolo
10/29/2008

Aggiornamento: novembre 2007

Copia tutti gli elementi dell'insieme Cursors corrente nella matrice unidimensionale specificata, a partire dall'indice della matrice di destinazione specificato.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

'Dichiarazione
Public Sub CopyTo ( _
    array As Array, _
    index As Integer _
)
'Utilizzo
Dim instance As Cursors
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
)

Parametri

array
Tipo: System.Array
Matrice unidimensionale che rappresenta la destinazione degli elementi copiati dall'insieme. La matrice deve avere indicizzazione in base zero.

index
Tipo: System.Int32
Indice in base zero del parametro matrice in corrispondenza del quale ha inizio la copia.

Implementa

ICollection.CopyTo(Array, Int32)

Note

Gli elementi vengono copiati nell'oggetto System.Array nello stesso ordine in cui l'enumeratore scorre l'oggetto Cursors.

Viene generata un'eccezione se:

Il parametro array è un riferimento nullriferimento null (Nothing in Visual Basic) (Nothing in Microsoft® Visual Basic® .NET).
Il parametro index è minore di zero.
Il parametro array è multidimensionale.
Il parametro index è uguale o maggiore della lunghezza del parametro array.
Il numero di elementi nell'insieme è maggiore dello spazio disponibile dal parametro index alla fine del parametro array di destinazione.

Non è possibile eseguire il cast automatico del tipo dell'insieme al tipo del parametro array di destinazione. Tuttavia, questo metodo copia solo gli elementi nelle matrici dello stesso tipo come elementi dell'insieme o matrici di tipo System.Object. Il tentativo di copia in un altro tipo di matrice comporta la generazione di un'eccezione System.InvalidCastException.

Questo metodo è sincronizzato.

Esempi

In questo esempio C# viene compilata parte di una matrice di oggetti Cursor con l'intero contenuto dell'insieme InkCollector.Cursors, a partire dall'elemento 1 (il secondo elemento in una matrice in base zero) della matrice di destinazione theCopies e lasciando vuoto il primo elemento della matrice di destinazione (con indice 0).

Cursor[] theCopies = new Cursor[theInkCollector.Cursors.Count + 1];
theInkCollector.Cursors.CopyTo(theCopies, 1);

In questo esempio Visual Basic .NET viene compilata parte di una matrice di oggetti Cursor con l'intero contenuto dell'insieme InkCollector.Cursors, a partire dall'elemento 1 (il secondo elemento in una matrice in base zero) della matrice di destinazione theCopies e lasciando vuoto il primo elemento della matrice di destinazione (con indice 0).

Dim theCopies(theInkCollector.Cursors.Count) As Cursor
theInkCollector.Cursors.CopyTo(theCopies, 1)

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Informazioni sulla versione

.NET Framework

Supportato in: 3.0

Vedere anche

Riferimenti

Cursors Classe

Membri Cursors

Spazio dei nomi Microsoft.Ink

Condividi tramite