List<T>.CopyTo Methode

Definition

Namespace:: System.Collections.Generic

Assemblys:: mscorlib.dll, System.Collections.dll

Assembly:: mscorlib.dll

Assembly:: System.Collections.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Kopiert den List<T> oder einen Teil davon in ein Array.

Überlädt

Name	Beschreibung
CopyTo(T[], Int32)	Kopiert das Gesamte List<T> in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.
CopyTo(Int32, T[], Int32, Int32)	Kopiert einen Bereich von Elementen aus dem List<T> in ein kompatibles eindimensionales Array ab dem angegebenen Index des Zielarrays.
CopyTo(T[])	Kopiert das Gesamte List<T> in ein kompatibles eindimensionales Array, beginnend am Anfang des Zielarrays.

Beispiele

Im folgenden Beispiel werden alle drei Überladungen der CopyTo Methode veranschaulicht. Eine List<T> Von Zeichenfolgen wird erstellt und mit 5 Zeichenfolgen aufgefüllt. Es wird ein leeres Zeichenfolgenarray mit 15 Elementen erstellt, und die CopyTo(T[]) Methodenüberladung wird verwendet, um alle Elemente der Liste an das Array zu kopieren, das am ersten Element des Arrays beginnt. Die CopyTo(T[], Int32) Methodenüberladung wird verwendet, um alle Elemente der Liste an das Array zu kopieren, das am Arrayindex 6 beginnt (wobei Index 5 leer bleibt). 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, das am Arrayindex 12 beginnt (wobei Index 11 leer bleibt). Der Inhalt des Arrays wird dann angezeigt.

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)

Kopiert das Gesamte List<T> in ein kompatibles eindimensionales Array, beginnend am angegebenen Index des Zielarrays.

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 Element, das das Ziel der elemente ist, aus List<T>denen kopiert wurde. Die Array 0-basierte Indizierung muss nullbasiert sein.

arrayIndex: Int32

Der nullbasierte Index, in array dem das Kopieren beginnt.

Implementiert

CopyTo(T[], Int32)

Ausnahmen

ArgumentNullException

array ist null.

ArgumentOutOfRangeException

arrayIndex ist kleiner als 0.

ArgumentException

Die Anzahl der Elemente in der Quelle List<T> ist größer als der verfügbare Platz vom arrayIndex Ende des Ziels array.

Hinweise

Diese Methode verwendet Array.Copy , um die Elemente zu kopieren.

Die Elemente werden in die gleiche Reihenfolge kopiert Array , in der der Enumerationsgeber durch die List<T>.

Diese Methode ist ein O(n)-Vorgang, wobei n ist Count.

Gilt für:

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

Kopiert einen Bereich von Elementen aus dem List<T> in ein kompatibles eindimensionales Array ab dem angegebenen Index des Zielarrays.

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

Der nullbasierte Index in der Quelle List<T> , an der das Kopieren beginnt.

array: T[]

Das eindimensionale Array Element, das das Ziel der elemente ist, aus List<T>denen kopiert wurde. Die Array 0-basierte Indizierung muss nullbasiert sein.

arrayIndex: Int32

Der nullbasierte Index, in array dem das Kopieren beginnt.

count: Int32

Die Anzahl der zu kopierenden Elemente.

Ausnahmen

ArgumentNullException

array ist null.

ArgumentOutOfRangeException

index ist kleiner als 0.

-oder-

arrayIndex ist kleiner als 0.

-oder-

count ist kleiner als 0.

ArgumentException

index ist gleich oder größer als die Count List<T>Quelle.

-oder-

Die Anzahl der Elemente vom index Ende der Quelle List<T> ist größer als der verfügbare Platz vom arrayIndex Ende des Ziels array.

Hinweise

Diese Methode verwendet Array.Copy , um die Elemente zu kopieren.

Die Elemente werden in die gleiche Reihenfolge kopiert Array , in der der Enumerationsgeber durch die List<T>.

Diese Methode ist ein O(n)-Vorgang, wobei n ist count.

Gilt für:

CopyTo(T[])

Kopiert das Gesamte List<T> in ein kompatibles eindimensionales Array, beginnend am Anfang des Zielarrays.

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 Element, das das Ziel der elemente ist, aus List<T>denen kopiert wurde. Die Array 0-basierte Indizierung muss nullbasiert sein.

Ausnahmen

ArgumentNullException

array ist null.

ArgumentException

Die Anzahl der Elemente in der Quelle List<T> ist größer als die Anzahl der Elemente, die das Ziel array enthalten kann.

Hinweise

Diese Methode verwendet Array.Copy , um die Elemente zu kopieren.

Die Elemente werden in die gleiche Reihenfolge kopiert Array , in der der Enumerationsgeber durch die List<T>.

Diese Methode ist ein O(n)-Vorgang, wobei n ist Count.

Gilt für:

Feedback

War diese Seite hilfreich?