List<T>.CopyTo Método
Definición
Sobrecargas
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) |
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[]) |
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. |
Ejemplos
En el ejemplo siguiente se muestran las tres sobrecargas del CopyTo 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 CopyTo(T[]) se 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, la CopyTo(Int32, T[], Int32, Int32) 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
CopyTo(T[], Int32)
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
Índice de base cero en la array
donde comienza la copia.The zero-based index in array
at which copying begins.
Implementaciones
Excepciones
array
es null
.array
is null
.
arrayIndex
es menor que 0.arrayIndex
is less than 0.
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
.
Comentarios
Este método usa Array.Copy para copiar los elementos.This method uses Array.Copy to copy the elements.
Los elementos se copian en Array 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
CopyTo(Int32, T[], Int32, Int32)
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
Í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
Índice de base cero en la array
donde comienza la copia.The zero-based index in array
at which copying begins.
- count
- Int32
Número de elementos que se van a copiar.The number of elements to copy.
Excepciones
array
es null
.array
is null
.
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 desde 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
.
Comentarios
Este método usa Array.Copy para copiar los elementos.This method uses Array.Copy to copy the elements.
Los elementos se copian en Array 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
CopyTo(T[])
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>. La matriz Array debe tener una indización de base cero.The Array must have zero-based indexing.
Excepciones
array
es null
.array
is null
.
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.
Comentarios
Este método usa Array.Copy para copiar los elementos.This method uses Array.Copy to copy the elements.
Los elementos se copian en Array 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.