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

Definition

Kopiert List<T> oder einen Teil davon in ein Array.Copies the List<T> or a portion of it to an array.

Überlädt

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

Kopiert die gesamte List<T> in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.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)

Kopiert einen Bereich von Elementen aus der List<T> in ein kompatibles eindimensionales Array, beginnend ab dem angegebenen Index im Zielarray.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[])

Kopiert die gesamte List<T> in ein kompatibles eindimensionales Array, wobei am Anfang des Zielarrays begonnen wird.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)

Kopiert die gesamte List<T> in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.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)

Parameter

array
T[]

Das eindimensionale Array, das das Ziel der aus der List<T> kopierten Elemente ist.The one-dimensional Array that is the destination of the elements copied from List<T>. Für das Array muss eine nullbasierte Indizierung verwendet werden.The Array must have zero-based indexing.

arrayIndex
Int32 Int32 Int32 Int32

Der nullbasierte Index im array, bei dem der Kopiervorgang beginnt.The zero-based index in array at which copying begins.

Implementiert

Ausnahmen

Die Anzahl der Elemente in der Quell-List<T> ist größer als der verfügbare Platz vom arrayIndex bis zum Ende des Ziel-arrays.The number of elements in the source List<T> is greater than the available space from arrayIndex to the end of the destination array.

Beispiele

Im folgenden Beispiel werden alle drei über Ladungen CopyTo der-Methode veranschaulicht.The following example demonstrates all three overloads of the CopyTo method. Eine List<T> von Zeichen folgen wird erstellt und mit 5 Zeichen folgen gefüllt.A List<T> of strings is created and populated with 5 strings. Ein leeres Zeichen folgen Array mit 15 Elementen wird erstellt, und CopyTo(T[]) die-Methoden Überladung wird verwendet, um alle Elemente der Liste in das Array zu kopieren, beginnend beim ersten Element des Arrays.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. Die CopyTo(T[], Int32) -Methoden Überladung wird verwendet, um alle Elemente der Liste in das Array zu kopieren, beginnend am Array Index 6 (wobei Index 5 leer bleibt).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). Schließlich wird die CopyTo(Int32, T[], Int32, Int32) -Methoden Überladung verwendet, um 3 Elemente aus der Liste, beginnend mit Index 2, in das Array zu kopieren, beginnend am Array Index 12 (wobei Index 11 leer bleibt).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). Daraufhin wird der Inhalt des Arrays angezeigt.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

Hinweise

Diese Methode verwendet Array.Copy , um die Elemente zu kopieren.This method uses Array.Copy to copy the elements.

Die Elemente werden Array in derselben Reihenfolge in den kopiert, in der der Enumerator List<T>durchläuft.The elements are copied to the Array in the same order in which the enumerator iterates through the List<T>.

Diese Methode ist ein O (n)-Vorgang, ** bei dem Countn gleich ist.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)

Kopiert einen Bereich von Elementen aus der List<T> in ein kompatibles eindimensionales Array, beginnend ab dem angegebenen Index im Zielarray.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)

Parameter

index
Int32 Int32 Int32 Int32

Der nullbasierte Index in der Quell-List<T>, ab dem mit dem Kopieren begonnen wird.The zero-based index in the source List<T> at which copying begins.

array
T[]

Das eindimensionale Array , das das Ziel der aus der List<T>kopierten Elemente ist.The one-dimensional Array that is the destination of the elements copied from List<T>. Für das Array muss eine nullbasierte Indizierung verwendet werden.The Array must have zero-based indexing.

arrayIndex
Int32 Int32 Int32 Int32

Der nullbasierte Index im array, bei dem der Kopiervorgang beginnt.The zero-based index in array at which copying begins.

count
Int32 Int32 Int32 Int32

Die Anzahl der zu kopierenden Elemente.The number of elements to copy.

Ausnahmen

index ist kleiner als 0.index is less than 0.

- oder --or- arrayIndex ist kleiner als 0.arrayIndex is less than 0.

- oder --or- count ist kleiner als 0.count is less than 0.

index ist gleich oder größer als die Count der Quell-List<T>.index is equal to or greater than the Count of the source List<T>.

- oder --or- Die Anzahl der Elemente ab index bis zum Ende der Quell-List<T> ist größer als der zwischen arrayIndex und dem Ende des Ziel-array verfügbare Raum.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.

Beispiele

Im folgenden Beispiel werden alle drei über Ladungen CopyTo der-Methode veranschaulicht.The following example demonstrates all three overloads of the CopyTo method. Eine List<T> von Zeichen folgen wird erstellt und mit 5 Zeichen folgen gefüllt.A List<T> of strings is created and populated with 5 strings. Ein leeres Zeichen folgen Array mit 15 Elementen wird erstellt, und CopyTo(T[]) die-Methoden Überladung wird verwendet, um alle Elemente der Liste in das Array zu kopieren, beginnend beim ersten Element des Arrays.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. Die CopyTo(T[], Int32) -Methoden Überladung wird verwendet, um alle Elemente der Liste in das Array zu kopieren, beginnend am Array Index 6 (wobei Index 5 leer bleibt).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). Schließlich wird die CopyTo(Int32, T[], Int32, Int32) -Methoden Überladung verwendet, um 3 Elemente aus der Liste, beginnend mit Index 2, in das Array zu kopieren, beginnend am Array Index 12 (wobei Index 11 leer bleibt).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). Daraufhin wird der Inhalt des Arrays angezeigt.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

Hinweise

Diese Methode verwendet Array.Copy , um die Elemente zu kopieren.This method uses Array.Copy to copy the elements.

Die Elemente werden Array in derselben Reihenfolge in den kopiert, in der der Enumerator List<T>durchläuft.The elements are copied to the Array in the same order in which the enumerator iterates through the List<T>.

Diese Methode ist ein O (n)-Vorgang, ** bei dem countn gleich ist.This method is an O(n) operation, where n is count.

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

Kopiert die gesamte List<T> in ein kompatibles eindimensionales Array, wobei am Anfang des Zielarrays begonnen wird.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())

Parameter

array
T[]

Das eindimensionale Array, das das Ziel der aus der List<T> kopierten Elemente ist.The one-dimensional Array that is the destination of the elements copied from List<T>. Für das Array muss eine nullbasierte Indizierung verwendet werden.The Array must have zero-based indexing.

Ausnahmen

Die Anzahl der Elemente in der Quell-List<T> ist größer als die Anzahl der Elemente, die das Ziel-array enthalten kann.The number of elements in the source List<T> is greater than the number of elements that the destination array can contain.

Beispiele

Im folgenden Beispiel werden alle drei über Ladungen CopyTo der-Methode veranschaulicht.The following example demonstrates all three overloads of the CopyTo method. Eine List<T> von Zeichen folgen wird erstellt und mit 5 Zeichen folgen gefüllt.A List<T> of strings is created and populated with 5 strings. Ein leeres Zeichen folgen Array mit 15 Elementen wird erstellt, und CopyTo(T[]) die-Methoden Überladung wird verwendet, um alle Elemente der Liste in das Array zu kopieren, beginnend beim ersten Element des Arrays.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. Die CopyTo(T[], Int32) -Methoden Überladung wird verwendet, um alle Elemente der Liste in das Array zu kopieren, beginnend am Array Index 6 (wobei Index 5 leer bleibt).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). Schließlich wird die CopyTo(Int32, T[], Int32, Int32) -Methoden Überladung verwendet, um 3 Elemente aus der Liste, beginnend mit Index 2, in das Array zu kopieren, beginnend am Array Index 12 (wobei Index 11 leer bleibt).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). Daraufhin wird der Inhalt des Arrays angezeigt.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

Hinweise

Diese Methode verwendet Array.Copy , um die Elemente zu kopieren.This method uses Array.Copy to copy the elements.

Die Elemente werden Array in derselben Reihenfolge in den kopiert, in der der Enumerator List<T>durchläuft.The elements are copied to the Array in the same order in which the enumerator iterates through the List<T>.

Diese Methode ist ein O (n)-Vorgang, ** bei dem Countn gleich ist.This method is an O(n) operation, where n is Count.

Gilt für: