List<T>.CopyTo Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Copia a List<T> parte ou uma parte dela para uma matriz.
Sobrecargas
| Nome | Description |
|---|---|
| CopyTo(T[], Int32) |
Copia o todo List<T> para uma matriz unidimensional compatível, começando no índice especificado da matriz de destino. |
| CopyTo(Int32, T[], Int32, Int32) |
Copia um intervalo de elementos da List<T> matriz unidimensional compatível, começando no índice especificado da matriz de destino. |
| CopyTo(T[]) |
Copia o todo List<T> para uma matriz unidimensional compatível, começando no início da matriz de destino. |
Exemplos
O exemplo a seguir demonstra todas as três sobrecargas do CopyTo método. Uma List<T> das cadeias de caracteres é criada e preenchida com 5 cadeias de caracteres. Uma matriz de cadeia de caracteres vazia de 15 elementos é criada e a sobrecarga do CopyTo(T[]) método é usada para copiar todos os elementos da lista para a matriz que começa no primeiro elemento da matriz. A CopyTo(T[], Int32) sobrecarga do método é usada para copiar todos os elementos da lista para a matriz começando no índice de matriz 6 (deixando o índice 5 vazio). Por fim, a sobrecarga do CopyTo(Int32, T[], Int32, Int32) método é usada para copiar 3 elementos da lista, começando com o índice 2, para a matriz começando no índice de matriz 12 (deixando o índice 11 vazio). Em seguida, o conteúdo da matriz é 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 o todo List<T> para uma matriz unidimensional compatível, começando no índice especificado da matriz de destino.
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>. O Array deve ter indexação baseada em zero.
- arrayIndex
- Int32
O índice baseado em zero no array qual a cópia começa.
Implementações
Exceções
array é null.
arrayIndex é menor que 0.
O número de elementos na origem List<T> é maior do que o espaço disponível de arrayIndex até o final do destino array.
Comentários
Esse método usa Array.Copy para copiar os elementos.
Os elementos são copiados para a Array mesma ordem na qual o enumerador itera por meio do List<T>.
Esse método é uma operação O(n), em que n está 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 intervalo de elementos da List<T> matriz unidimensional compatível, começando no índice especificado da matriz de destino.
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
- array
- T[]
O unidimensional Array que é o destino dos elementos copiados de List<T>. O Array deve ter indexação baseada em zero.
- arrayIndex
- Int32
O índice baseado em zero no array qual a cópia começa.
- count
- Int32
O número de elementos a serem copiados.
Exceções
array é null.
index é menor que 0.
- ou -
arrayIndex é menor que 0.
- ou -
count é menor que 0.
index é igual ou maior que o Count da fonte List<T>.
- ou -
O número de elementos de index até o final da origem List<T> é maior do que o espaço disponível de arrayIndex até o final do destino array.
Comentários
Esse método usa Array.Copy para copiar os elementos.
Os elementos são copiados para a Array mesma ordem na qual o enumerador itera por meio do List<T>.
Esse método é uma operação O(n), em que n está count.
Aplica-se a
CopyTo(T[])
- Origem:
- List.cs
- Origem:
- List.cs
- Origem:
- List.cs
- Origem:
- List.cs
- Origem:
- List.cs
Copia o todo List<T> para uma matriz unidimensional compatível, começando no início da matriz de destino.
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>. O Array deve ter indexação baseada em zero.
Exceções
array é null.
O número de elementos na origem List<T> é maior do que o número de elementos que o destino array pode conter.
Comentários
Esse método usa Array.Copy para copiar os elementos.
Os elementos são copiados para a Array mesma ordem na qual o enumerador itera por meio do List<T>.
Esse método é uma operação O(n), em que n está Count.