List<T>.CopyTo List<T>.CopyTo List<T>.CopyTo List<T>.CopyTo Method

Definición

Copia la totalidad de List<T> o una parte en una matriz.Copies the List<T> or a portion of it to an array.

Sobrecargas

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

Copia la totalidad de List<T> en una matriz unidimensional compatible, empezando por el índice especificado de la matriz de destino.Copies the entire List<T> to a compatible one-dimensional array, starting at the specified index of the target array.

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

Copia un intervalo de elementos de List<T> en una matriz unidimensional compatible, empezando en el índice especificado de la matriz de destino.Copies a range of elements from the List<T> to a compatible one-dimensional array, starting at the specified index of the target array.

CopyTo(T[]) CopyTo(T[]) CopyTo(T[]) CopyTo(T[])

Copia toda la List<T> en una matriz unidimensional compatible, empezando en el principio de la matriz de destino.Copies the entire List<T> to a compatible one-dimensional array, starting at the beginning of the target array.

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

Copia la totalidad de List<T> en una matriz unidimensional compatible, empezando por el índice especificado de la matriz de destino.Copies the entire List<T> to a compatible one-dimensional array, starting at the specified index of the target array.

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[]

Array unidimensional que constituye el destino de los elementos copiados de List<T>.The one-dimensional Array that is the destination of the elements copied from List<T>. La matriz Array debe tener una indización de base cero.The Array must have zero-based indexing.

arrayIndex
Int32 Int32 Int32 Int32

Índice de base cero en la array donde comienza la copia.The zero-based index in array at which copying begins.

Implementaciones

Excepciones

El número de elementos de la List<T> de origen es mayor que el espacio disponible desde arrayIndex hasta el final de la array de destino.The number of elements in the source List<T> is greater than the available space from arrayIndex to the end of the destination array.

Ejemplos

En el ejemplo siguiente se muestran las tres sobrecargas CopyTo del método.The following example demonstrates all three overloads of the CopyTo method. Un List<T> de cadenas se crea y rellena con cinco cadenas.A List<T> of strings is created and populated with 5 strings. Se crea una matriz de cadenas vacía de 15 elementos y se CopyTo(T[]) utiliza la sobrecarga del método para copiar todos los elementos de la lista en la matriz a partir del primer elemento de la matriz.An empty string array of 15 elements is created, and the CopyTo(T[]) method overload is used to copy all the elements of the list to the array beginning at the first element of the array. La CopyTo(T[], Int32) sobrecarga del método se usa para copiar todos los elementos de la lista en la matriz a partir de la matriz índice 6 (saliendo del índice 5 vacío).The CopyTo(T[], 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). Por último, CopyTo(Int32, T[], Int32, Int32) la sobrecarga del método se usa para copiar 3 elementos de la lista, empezando por el índice 2, a la matriz que comienza en el índice de matriz 12 (saliendo del índice 11 vacío).Finally, the CopyTo(Int32, T[], Int32, 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). A continuación, se muestra el contenido de la matriz.The contents of the array are then displayed.

using namespace System;
using namespace System::Collections::Generic;

void main()
{
    List<String^>^ dinosaurs = gcnew List<String^>();

    dinosaurs->Add("Tyrannosaurus");
    dinosaurs->Add("Amargasaurus");
    dinosaurs->Add("Mamenchisaurus");
    dinosaurs->Add("Brachiosaurus");
    dinosaurs->Add("Compsognathus");

    Console::WriteLine();
    for each(String^ dinosaurs in dinosaurs )
    {
        Console::WriteLine(dinosaurs);
    }

    // Create an array of 15 strings.
    array<String^>^ arr = gcnew array<String^>(15);

    dinosaurs->CopyTo(arr);
    dinosaurs->CopyTo(arr, 6);
    dinosaurs->CopyTo(2, arr, 12, 3);

    Console::WriteLine("\nContents of the array:");
    for each(String^ dinosaurs in arr )
    {
        Console::WriteLine(dinosaurs);
    }
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Deinonychus
Tyrannosaurus
Compsognathus

IndexOf("Tyrannosaurus"): 0

IndexOf("Tyrannosaurus", 3): 5

IndexOf("Tyrannosaurus", 2, 2): -1
 */
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

Comentarios

Este método usa Array.Copy para copiar los elementos.This method uses Array.Copy to copy the elements.

Los elementos se copian Array en en el mismo orden en el que el enumerador recorre en iteración la. List<T>The elements are copied to the Array in the same order in which the enumerator iterates through the List<T>.

Este método es una operación O (n), donde n es Count.This method is an O(n) operation, where n is Count.

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

Copia un intervalo de elementos de List<T> en una matriz unidimensional compatible, empezando en el índice especificado de la matriz de destino.Copies a range of elements from the List<T> to a compatible one-dimensional array, starting at the specified index of the target array.

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 Int32 Int32 Int32

Índice de base cero de la List<T> de origen donde comienza la copia.The zero-based index in the source List<T> at which copying begins.

array
T[]

Array unidimensional que constituye el destino de los elementos copiados de List<T>.The one-dimensional Array that is the destination of the elements copied from List<T>. La matriz Array debe tener una indización de base cero.The Array must have zero-based indexing.

arrayIndex
Int32 Int32 Int32 Int32

Índice de base cero en la array donde comienza la copia.The zero-based index in array at which copying begins.

count
Int32 Int32 Int32 Int32

Número de elementos que se van a copiar.The number of elements to copy.

Excepciones

index es menor que 0.index is less than 0.

O bien-or- arrayIndex es menor que 0.arrayIndex is less than 0.

O bien-or- count es menor que 0.count is less than 0.

index es igual o mayor que la longitud de Count de List<T> de origen.index is equal to or greater than the Count of the source List<T>.

O bien-or- El número de elementos de index hasta el final de List<T> de origen es mayor que el espacio disponible desde arrayIndex hasta el final de array de destino.The number of elements from index to the end of the source List<T> is greater than the available space from arrayIndex to the end of the destination array.

Ejemplos

En el ejemplo siguiente se muestran las tres sobrecargas CopyTo del método.The following example demonstrates all three overloads of the CopyTo method. Un List<T> de cadenas se crea y rellena con cinco cadenas.A List<T> of strings is created and populated with 5 strings. Se crea una matriz de cadenas vacía de 15 elementos y se CopyTo(T[]) utiliza la sobrecarga del método para copiar todos los elementos de la lista en la matriz a partir del primer elemento de la matriz.An empty string array of 15 elements is created, and the CopyTo(T[]) method overload is used to copy all the elements of the list to the array beginning at the first element of the array. La CopyTo(T[], Int32) sobrecarga del método se usa para copiar todos los elementos de la lista en la matriz a partir de la matriz índice 6 (saliendo del índice 5 vacío).The CopyTo(T[], 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). Por último, CopyTo(Int32, T[], Int32, Int32) la sobrecarga del método se usa para copiar 3 elementos de la lista, empezando por el índice 2, a la matriz que comienza en el índice de matriz 12 (saliendo del índice 11 vacío).Finally, the CopyTo(Int32, T[], Int32, 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). A continuación, se muestra el contenido de la matriz.The contents of the array are then displayed.

using namespace System;
using namespace System::Collections::Generic;

void main()
{
    List<String^>^ dinosaurs = gcnew List<String^>();

    dinosaurs->Add("Tyrannosaurus");
    dinosaurs->Add("Amargasaurus");
    dinosaurs->Add("Mamenchisaurus");
    dinosaurs->Add("Brachiosaurus");
    dinosaurs->Add("Compsognathus");

    Console::WriteLine();
    for each(String^ dinosaurs in dinosaurs )
    {
        Console::WriteLine(dinosaurs);
    }

    // Create an array of 15 strings.
    array<String^>^ arr = gcnew array<String^>(15);

    dinosaurs->CopyTo(arr);
    dinosaurs->CopyTo(arr, 6);
    dinosaurs->CopyTo(2, arr, 12, 3);

    Console::WriteLine("\nContents of the array:");
    for each(String^ dinosaurs in arr )
    {
        Console::WriteLine(dinosaurs);
    }
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Deinonychus
Tyrannosaurus
Compsognathus

IndexOf("Tyrannosaurus"): 0

IndexOf("Tyrannosaurus", 3): 5

IndexOf("Tyrannosaurus", 2, 2): -1
 */
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

Comentarios

Este método usa Array.Copy para copiar los elementos.This method uses Array.Copy to copy the elements.

Los elementos se copian Array en en el mismo orden en el que el enumerador recorre en iteración la. List<T>The elements are copied to the Array in the same order in which the enumerator iterates through the List<T>.

Este método es una operación O (n), donde n es count.This method is an O(n) operation, where n is count.

CopyTo(T[]) CopyTo(T[]) CopyTo(T[]) CopyTo(T[])

Copia toda la List<T> en una matriz unidimensional compatible, empezando en el principio de la matriz de destino.Copies the entire List<T> to a compatible one-dimensional array, starting at the beginning of the target array.

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[]

Array unidimensional que constituye el destino de los elementos copiados de List<T>.The one-dimensional Array that is the destination of the elements copied from List<T>. Array debe tener una indización de base cero.The Array must have zero-based indexing.

Excepciones

El número de elementos del List<T> de origen es mayor que el número de elementos que puede contener el array de destino.The number of elements in the source List<T> is greater than the number of elements that the destination array can contain.

Ejemplos

En el ejemplo siguiente se muestran las tres sobrecargas CopyTo del método.The following example demonstrates all three overloads of the CopyTo method. Un List<T> de cadenas se crea y rellena con cinco cadenas.A List<T> of strings is created and populated with 5 strings. Se crea una matriz de cadenas vacía de 15 elementos y se CopyTo(T[]) utiliza la sobrecarga del método para copiar todos los elementos de la lista en la matriz a partir del primer elemento de la matriz.An empty string array of 15 elements is created, and the CopyTo(T[]) method overload is used to copy all the elements of the list to the array beginning at the first element of the array. La CopyTo(T[], Int32) sobrecarga del método se usa para copiar todos los elementos de la lista en la matriz a partir de la matriz índice 6 (saliendo del índice 5 vacío).The CopyTo(T[], 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). Por último, CopyTo(Int32, T[], Int32, Int32) la sobrecarga del método se usa para copiar 3 elementos de la lista, empezando por el índice 2, a la matriz que comienza en el índice de matriz 12 (saliendo del índice 11 vacío).Finally, the CopyTo(Int32, T[], Int32, 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). A continuación, se muestra el contenido de la matriz.The contents of the array are then displayed.

using namespace System;
using namespace System::Collections::Generic;

void main()
{
    List<String^>^ dinosaurs = gcnew List<String^>();

    dinosaurs->Add("Tyrannosaurus");
    dinosaurs->Add("Amargasaurus");
    dinosaurs->Add("Mamenchisaurus");
    dinosaurs->Add("Brachiosaurus");
    dinosaurs->Add("Compsognathus");

    Console::WriteLine();
    for each(String^ dinosaurs in dinosaurs )
    {
        Console::WriteLine(dinosaurs);
    }

    // Create an array of 15 strings.
    array<String^>^ arr = gcnew array<String^>(15);

    dinosaurs->CopyTo(arr);
    dinosaurs->CopyTo(arr, 6);
    dinosaurs->CopyTo(2, arr, 12, 3);

    Console::WriteLine("\nContents of the array:");
    for each(String^ dinosaurs in arr )
    {
        Console::WriteLine(dinosaurs);
    }
}

/* This code example produces the following output:

Tyrannosaurus
Amargasaurus
Mamenchisaurus
Brachiosaurus
Deinonychus
Tyrannosaurus
Compsognathus

IndexOf("Tyrannosaurus"): 0

IndexOf("Tyrannosaurus", 3): 5

IndexOf("Tyrannosaurus", 2, 2): -1
 */
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

Comentarios

Este método usa Array.Copy para copiar los elementos.This method uses Array.Copy to copy the elements.

Los elementos se copian Array en en el mismo orden en el que el enumerador recorre en iteración la. List<T>The elements are copied to the Array in the same order in which the enumerator iterates through the List<T>.

Este método es una operación O (n), donde n es Count.This method is an O(n) operation, where n is Count.

Se aplica a