List<T>.CopyTo Methode

Definitie

Naamruimte:: System.Collections.Generic

Assembly's:: mscorlib.dll, System.Collections.dll

Assembly:: mscorlib.dll

Assembly:: System.Collections.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Kopieert de List<T> of een deel ervan naar een matrix.

Overloads

Name	Description
CopyTo(T[], Int32)	Kopieert het hele List<T> naar een compatibele eendimensionale matrix, beginnend bij de opgegeven index van de doelmatrix.
CopyTo(Int32, T[], Int32, Int32)	Kopieert een bereik van elementen van de List<T> naar een compatibele eendimensionale matrix, te beginnen bij de opgegeven index van de doelmatrix.
CopyTo(T[])	Kopieert het hele List<T> naar een compatibele eendimensionale matrix, te beginnen bij het begin van de doelmatrix.

Voorbeelden

In het volgende voorbeeld ziet u alle drie de overbelastingen van de CopyTo methode. Er wordt een List<T> tekenreeks gemaakt en gevuld met 5 tekenreeksen. Er wordt een lege tekenreeksmatrix van 15 elementen gemaakt en de overbelasting van de CopyTo(T[]) methode wordt gebruikt om alle elementen van de lijst te kopiëren naar de matrix die begint bij het eerste element van de matrix. De CopyTo(T[], Int32) overbelasting van de methode wordt gebruikt om alle elementen van de lijst te kopiëren naar de matrix vanaf matrixindex 6 (waarbij index 5 leeg blijft). Ten slotte wordt de overbelasting van de methode gebruikt voor het CopyTo(Int32, T[], Int32, Int32) kopiëren van 3 elementen uit de lijst, te beginnen met index 2, naar de matrix die begint bij matrixindex 12 (waardoor index 11 leeg blijft). De inhoud van de matrix wordt vervolgens weergegeven.

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)

Kopieert het hele List<T> naar een compatibele eendimensionale matrix, beginnend bij de opgegeven index van de doelmatrix.

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)

Parameters

array: T[]

De eendimensionale Array die de bestemming is van de elementen die zijn gekopieerd uit List<T>. De Array indexering op basis van nul moet zijn.

arrayIndex: Int32

De op nul gebaseerde index array waarin kopiëren begint.

Implementeringen

CopyTo(T[], Int32)

Uitzonderingen

ArgumentNullException

array is null.

ArgumentOutOfRangeException

arrayIndex is kleiner dan 0.

ArgumentException

Het aantal elementen in de bron List<T> is groter dan de beschikbare ruimte van arrayIndex tot het einde van de bestemming array.

Opmerkingen

Deze methode gebruikt Array.Copy om de elementen te kopiëren.

De elementen worden gekopieerd naar dezelfde Array volgorde waarin de enumerator doorloopt.List<T>

Deze methode is een O(n)-bewerking, waarbij n is Count.

Van toepassing op

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

Kopieert een bereik van elementen van de List<T> naar een compatibele eendimensionale matrix, te beginnen bij de opgegeven index van de doelmatrix.

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)

Parameters

index: Int32

De op nul gebaseerde index in de bron List<T> waarop kopiëren begint.

array: T[]

De eendimensionale Array die de bestemming is van de elementen die zijn gekopieerd uit List<T>. De Array indexering op basis van nul moet zijn.

arrayIndex: Int32

De op nul gebaseerde index array waarin kopiëren begint.

count: Int32

Het aantal elementen dat moet worden gekopieerd.

Uitzonderingen

ArgumentNullException

array is null.

ArgumentOutOfRangeException

index is kleiner dan 0.

– of –

arrayIndex is kleiner dan 0.

– of –

count is kleiner dan 0.

ArgumentException

index is gelijk aan of groter dan de Count bron List<T>.

– of –

Het aantal elementen van index tot het einde van de bron List<T> is groter dan de beschikbare ruimte van arrayIndex tot het einde van de bestemming array.

Opmerkingen

Deze methode gebruikt Array.Copy om de elementen te kopiëren.

De elementen worden gekopieerd naar dezelfde Array volgorde waarin de enumerator doorloopt.List<T>

Deze methode is een O(n)-bewerking, waarbij n is count.

Van toepassing op

CopyTo(T[])

Kopieert het hele List<T> naar een compatibele eendimensionale matrix, te beginnen bij het begin van de doelmatrix.

public:
 void CopyTo(cli::array <T> ^ array);

public void CopyTo(T[] array);

member this.CopyTo : 'T[] -> unit

Public Sub CopyTo (array As T())

Parameters

array: T[]

De eendimensionale Array die de bestemming is van de elementen die zijn gekopieerd uit List<T>. De Array indexering op basis van nul moet zijn.

Uitzonderingen

ArgumentNullException

array is null.

ArgumentException

Het aantal elementen in de bron List<T> is groter dan het aantal elementen dat de bestemming array kan bevatten.

Opmerkingen

Deze methode gebruikt Array.Copy om de elementen te kopiëren.

De elementen worden gekopieerd naar dezelfde Array volgorde waarin de enumerator doorloopt.List<T>

Deze methode is een O(n)-bewerking, waarbij n is Count.

Van toepassing op

Feedback

Is deze pagina nuttig?