Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo List<T>.CopyTo (Int32, T[], Int32, Int32)

 

Data di pubblicazione: ottobre 2016

Copia un intervallo di elementi da List<T> in una matrice compatibile unidimensionale, a partire dall'indice specificato della matrice di destinazione.

Spazio dei nomi:   System.Collections.Generic
Assembly:  mscorlib (in mscorlib.dll)

public void CopyTo(
	int index,
	T[] array,
	int arrayIndex,
	int count
)

Parametri

index
Type: System.Int32

Indice in base zero dell'oggetto List<T> di origine a partire dal quale viene effettuata la copia.

array
Type: T[]

Oggetto Array unidimensionale che rappresenta la destinazione degli elementi copiati dall'oggetto List<T>. L'indicizzazione di Array deve essere in base zero.

arrayIndex
Type: System.Int32

Indice in base zero in array in corrispondenza del quale viene avviata la copia.

count
Type: System.Int32

Numero degli elementi da copiare.

Exception Condition
ArgumentNullException

array è null.

ArgumentOutOfRangeException

index è minore di 0.

-oppure-

arrayIndex è minore di 0.

-oppure-

count è minore di 0.

ArgumentException

index è maggiore o uguale al valore di Count dell'oggetto List<T> di origine.

-oppure-

Il numero di elementi da index alla fine dell'oggetto List<T> di origine è maggiore dello spazio disponibile da arrayIndex alla fine dell'oggetto array di destinazione.

This method uses Overload:System.Array.Copy to copy the elements.

The elements are copied to the T:System.Array in the same order in which the enumerator iterates through the T:System.Collections.Generic.List`1.

This method is an O(n) operation, where n is count.

The following example demonstrates all three overloads of the M:System.Collections.Generic.List`1.CopyTo(`0[]) method. A T:System.Collections.Generic.List`1 of strings is created and populated with 5 strings. An empty string array of 15 elements is created, and the M:System.Collections.Generic.List`1.CopyTo(`0[]) method overload is used to copy all the elements of the list to the array beginning at the first element of the array. The M:System.Collections.Generic.List`1.CopyTo(`0[],System.Int32) method overload is used to copy all the elements of the list to the array beginning at array index 6 (leaving index 5 empty). Finally, the M:System.Collections.Generic.List`1.CopyTo(System.Int32,`0[],System.Int32,System.Int32) method overload is used to copy 3 elements from the list, beginning with index 2, to the array beginning at array index 12 (leaving index 11 empty). The contents of the array are then displayed.

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        List<string> dinosaurs = new List<string>();

        dinosaurs.Add("Tyrannosaurus");
        dinosaurs.Add("Amargasaurus");
        dinosaurs.Add("Mamenchisaurus");
        dinosaurs.Add("Brachiosaurus");
        dinosaurs.Add("Compsognathus");

        Console.WriteLine();
        foreach(string dinosaur in dinosaurs)
        {
            Console.WriteLine(dinosaur);
        }

        // Declare an array with 15 elements.
        string[] array = new string[15];

        dinosaurs.CopyTo(array);
        dinosaurs.CopyTo(array, 6);
        dinosaurs.CopyTo(2, array, 12, 3);

        Console.WriteLine("\nContents of the array:");
        foreach(string dinosaur in array)
        {
            Console.WriteLine(dinosaur);
        }
    }
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Compsognathus

Contents of the array:
Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Compsognathus

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Compsognathus

Mamenchisaurus
Brachiosaurus
Compsognathus
 */

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 2.0
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: