Metodo DivisionUnits.CopyTo

Articolo
10/29/2008

Aggiornamento: novembre 2007

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

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 gli elementi solo 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 è sincronizzato.

Esempi

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

DivisionUnit[] theCopies = new DivisionUnit[theDivisionUnits.Count + 1];
theDivisionUnits.CopyTo(theCopies, 1);

In questo esempio di Visual Basic .NET parte di una matrice di oggetti DivisionUnit viene riempita con l'intero contenuto dell'insieme DivisionUnits, theDivisionUnits, 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() As DivisionUnit
Redim theCopies(theDivisionUnits.Count + 1)
theDivisionUnits.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.