Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Método List<T>.CopyTo (T[])

Copia o inteiro List<T> para um compatível unidimensional array, desde o início da matriz de destino.

Namespace:  System.Collections.Generic
Assembly:  mscorlib (em mscorlib.dll)

public void CopyTo(
	T[] array
)

Parâmetros

array
Tipo: T[]
O unidimensionalArray que é o destino dos elementos copiado de List<T>. The Array deve ter a indexação com base em zero.

ExceçãoCondição
ArgumentNullException

array é null.

ArgumentException

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

Esse método usa Array.Copy Para copiar os elementos.

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

Esse método é um O (n) operação, onde n é Count.

O exemplo de código a seguir demonstra todos os três sobrecargas do CopyTo método. A List<T> seqüências de caracteres é criada e preenchida com seqüências de caracteres de 5. Uma matriz de seqüência de caracteres vazia de 15 elementos é criada e o CopyTo(T[]) sobrecarga de método é usada para copiar todos os elementos da lista para o início da matriz no primeiro elemento da matriz. The CopyTo(T[], Int32) sobrecarga de método é usada para copiar todos os elementos da lista para o início da matriz no índice de matriz 6 (deixando índice 5 vazio). Finalmente, a CopyTo(Int32, T[], Int32, Int32) sobrecarga de método é usada para copiar 3 elementos na lista, começando com o índice 2, para o início da matriz na matriz índice 12 (deixando índice 11 vazio). O Sumário da matriz é exibido.

using System;
using System.Collections.Generic;

publicclass Example
{
    publicstaticvoid 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
 */

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360

o.NET Framework e.NET Compact Framework não oferecem suporte a todas as versões de cada plataforma. Para obter uma lista de versões suportadas, consulte Requisitos de sistema do .NET framework.

.NET Framework

Compatível com: 3.5, 3.0, 2.0

.NET Compact Framework

Compatível com: 3.5, 2.0

XNA Framework

Compatível com: , 1.0
Mostrar: