Condividi tramite


Metodo CustomStrokes.CopyTo

Aggiornamento: novembre 2007

Copia tutti gli elementi dell'insieme CustomStrokes 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 CustomStrokes
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 CustomStrokes.

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 è maggiore o uguale alla lunghezza del parametro array.

  • Il numero di elementi nell'insieme è maggiore dello spazio disponibile dal parametro index alla fine del parametro array di destinazione.

Viene eseguito automaticamente il cast del tipo dell'insieme al tipo del parametro array di destinazione. Tuttavia, questo metodo copia solo gli elementi nelle matrici dello stesso tipo degli elementi dell'insieme o nelle 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 non è sincronizzato.

Esempi

In questo esempio di C# parte di una matrice di oggetti Strokes viene riempita con l'intero contenuto dell'insieme Ink.CustomStrokes, 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).

Strokes[] theCopies = new Strokes[theInkCollector.Ink.CustomStrokes.Count + 1];
theInkCollector.Ink.CustomStrokes.CopyTo(theCopies, 1);

In questo esempio di Visual Basic .NET parte di una matrice di oggetti Strokes viene riempita con l'intero contenuto dell'insieme Ink.CustomStrokes, 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.Ink.CustomStrokes.Count) As Strokes
theInkCollector.Ink.CustomStrokes.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

CustomStrokes Classe

Membri CustomStrokes

Spazio dei nomi Microsoft.Ink