List<T>.CopyTo Método

Definição

Copia ou List<T> uma parte dele para um array.

Sobrecargas

Name Descrição
CopyTo(T[], Int32)

Copia a totalidade List<T> para um array unidimensional compatível, começando no índice especificado do array-alvo.

CopyTo(Int32, T[], Int32, Int32)

Copia um conjunto de elementos desde o List<T> até um array unidimensional compatível, começando no índice especificado do array-alvo.

CopyTo(T[])

Copia a totalidade List<T> para um array unidimensional compatível, começando no início do array-alvo.

Exemplos

O exemplo seguinte demonstra as três sobrecargas do CopyTo método. A List<T> de cordas é criada e povoada com 5 cadeias. É criado um array de string vazio com 15 elementos, e a CopyTo(T[]) sobrecarga de métodos é usada para copiar todos os elementos da lista para o array começando no primeiro elemento do array. A CopyTo(T[], Int32) sobrecarga do método é usada para copiar todos os elementos da lista para o array a partir do índice 6 do array (deixando o índice 5 vazio). Finalmente, a CopyTo(Int32, T[], Int32, Int32) sobrecarga de métodos é usada para copiar 3 elementos da lista, começando pelo índice 2, para o array que começa no índice do array 12 (deixando o índice 11 vazio). O conteúdo do array é então exibido.

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
 */
Imports System.Collections.Generic

Public Class Example

    Public Shared Sub Main()

        Dim dinosaurs As New List(Of String)

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

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        ' Declare an array with 15 elements (0 through 14).
        Dim array(14) As String

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

        Console.WriteLine(vbLf & "Contents of the array:")
        For Each dinosaur As String In array
            Console.WriteLine(dinosaur)
        Next

    End Sub
End Class

' 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

CopyTo(T[], Int32)

Origem:
List.cs
Origem:
List.cs
Origem:
List.cs
Origem:
List.cs
Origem:
List.cs

Copia a totalidade List<T> para um array unidimensional compatível, começando no índice especificado do array-alvo.

public:
 virtual void CopyTo(cli::array <T> ^ array, int arrayIndex);
public void CopyTo(T[] array, int arrayIndex);
abstract member CopyTo : 'T[] * int -> unit
override this.CopyTo : 'T[] * int -> unit
Public Sub CopyTo (array As T(), arrayIndex As Integer)

Parâmetros

array
T[]

O unidimensional Array que é o destino dos elementos copiados de List<T>. A Array indexação deve ter base zero.

arrayIndex
Int32

O índice baseado em zero em array onde começa a cópia.

Implementações

Exceções

array é null.

arrayIndex é inferior a 0.

O número de elementos na fonte List<T> é maior do que o espaço disponível de arrayIndex até ao fim do destino array.

Observações

Este método serve Array.Copy para copiar os elementos.

Os elementos são copiados para o Array na mesma ordem em que o enumerador itera através do List<T>.

Este método é uma operação O(n), onde n é Count.

Aplica-se a

CopyTo(Int32, T[], Int32, Int32)

Origem:
List.cs
Origem:
List.cs
Origem:
List.cs
Origem:
List.cs
Origem:
List.cs

Copia um conjunto de elementos desde o List<T> até um array unidimensional compatível, começando no índice especificado do array-alvo.

public:
 void CopyTo(int index, cli::array <T> ^ array, int arrayIndex, int count);
public void CopyTo(int index, T[] array, int arrayIndex, int count);
member this.CopyTo : int * 'T[] * int * int -> unit
Public Sub CopyTo (index As Integer, array As T(), arrayIndex As Integer, count As Integer)

Parâmetros

index
Int32

O índice base zero na fonte List<T> onde a cópia começa.

array
T[]

O unidimensional Array que é o destino dos elementos copiados de List<T>. A Array indexação deve ter base zero.

arrayIndex
Int32

O índice baseado em zero em array onde começa a cópia.

count
Int32

O número de elementos a copiar.

Exceções

array é null.

index é inferior a 0.

-ou-

arrayIndex é inferior a 0.

-ou-

count é inferior a 0.

index é igual ou maior que o Count da fonte List<T>.

-ou-

O número de elementos de index até ao fim da fonte List<T> é maior do que o espaço disponível de arrayIndex até ao fim do destino array.

Observações

Este método serve Array.Copy para copiar os elementos.

Os elementos são copiados para o Array na mesma ordem em que o enumerador itera através do List<T>.

Este método é uma operação O(n), onde n é count.

Aplica-se a

CopyTo(T[])

Origem:
List.cs
Origem:
List.cs
Origem:
List.cs
Origem:
List.cs
Origem:
List.cs

Copia a totalidade List<T> para um array unidimensional compatível, começando no início do array-alvo.

public:
 void CopyTo(cli::array <T> ^ array);
public void CopyTo(T[] array);
member this.CopyTo : 'T[] -> unit
Public Sub CopyTo (array As T())

Parâmetros

array
T[]

O unidimensional Array que é o destino dos elementos copiados de List<T>. A Array indexação deve ter base zero.

Exceções

array é null.

O número de elementos na fonte List<T> é maior do que o número de elementos que o destino array pode conter.

Observações

Este método serve Array.Copy para copiar os elementos.

Os elementos são copiados para o Array na mesma ordem em que o enumerador itera através do List<T>.

Este método é uma operação O(n), onde n é Count.

Aplica-se a