Język

List<T>.CopyTo Metoda

Definicja

Kopiuje List<T> część lub do tablicy.

Przeciążenia

Nazwa Opis
CopyTo(T[], Int32)

Kopiuje całość List<T> do zgodnej tablicy jednowymiarowej, zaczynając od określonego indeksu tablicy docelowej.

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

Kopiuje szereg elementów z List<T> do zgodnej tablicy jednowymiarowej, zaczynając od określonego indeksu tablicy docelowej.

CopyTo(T[])

Kopiuje całość List<T> do zgodnej tablicy jednowymiarowej, zaczynając od początku tablicy docelowej.

Przykłady

W poniższym przykładzie przedstawiono wszystkie trzy przeciążenia CopyTo metody. Ciągi List<T> są tworzone i wypełniane 5 ciągami. Tworzona jest pusta tablica ciągów zawierająca 15 elementów, a CopyTo(T[]) przeciążenie metody służy do kopiowania wszystkich elementów listy do tablicy rozpoczynającej się od pierwszego elementu tablicy. Przeciążenie CopyTo(T[], Int32) metody służy do kopiowania wszystkich elementów listy do tablicy rozpoczynającej się od indeksu tablicy 6 (pozostawiając indeks 5 pusty). CopyTo(Int32, T[], Int32, Int32) Na koniec przeciążenie metody służy do kopiowania 3 elementów z listy, począwszy od indeksu 2, do tablicy rozpoczynającej się od indeksu tablicy 12 (pozostawiając indeks 11 pusty). Następnie zostanie wyświetlona zawartość tablicy.

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)

Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs

Kopiuje całość List<T> do zgodnej tablicy jednowymiarowej, zaczynając od określonego indeksu tablicy docelowej.

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)

Parametry

array
T[]

Jednowymiarowy Array obiekt docelowy elementów skopiowanych z List<T>elementu . Element Array musi mieć indeksowanie oparte na zerach.

arrayIndex
Int32

Indeks oparty na zera, w array którym rozpoczyna się kopiowanie.

Implementuje

Wyjątki

Parametr array ma wartość null.

arrayIndex wartość jest mniejsza niż 0.

Liczba elementów w źródle List<T> jest większa niż dostępna przestrzeń z arrayIndex do końca miejsca docelowego array.

Uwagi

Ta metoda służy Array.Copy do kopiowania elementów.

Elementy są kopiowane do Array elementu w tej samej kolejności, w której moduł wyliczający iteruje za pośrednictwem elementu List<T>.

Ta metoda jest operacją O(n), gdzie n to Count.

Dotyczy

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

Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs

Kopiuje szereg elementów z List<T> do zgodnej tablicy jednowymiarowej, zaczynając od określonego indeksu tablicy docelowej.

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)

Parametry

index
Int32

Indeks oparty na zera w źródle List<T> , w którym rozpoczyna się kopiowanie.

array
T[]

Jednowymiarowy Array obiekt docelowy elementów skopiowanych z List<T>elementu . Element Array musi mieć indeksowanie oparte na zerach.

arrayIndex
Int32

Indeks oparty na zera, w array którym rozpoczyna się kopiowanie.

count
Int32

Liczba elementów do skopiowania.

Wyjątki

Parametr array ma wartość null.

index wartość jest mniejsza niż 0.

— lub —

arrayIndex wartość jest mniejsza niż 0.

— lub —

count wartość jest mniejsza niż 0.

index jest równe lub większe niż Count źródło List<T>.

— lub —

Liczba elementów od index do końca źródła List<T> jest większa niż dostępna przestrzeń z arrayIndex do końca miejsca docelowego array.

Uwagi

Ta metoda służy Array.Copy do kopiowania elementów.

Elementy są kopiowane do Array elementu w tej samej kolejności, w której moduł wyliczający iteruje za pośrednictwem elementu List<T>.

Ta metoda jest operacją O(n), gdzie n to count.

Dotyczy

CopyTo(T[])

Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs
Źródło:
List.cs

Kopiuje całość List<T> do zgodnej tablicy jednowymiarowej, zaczynając od początku tablicy docelowej.

public:
 void CopyTo(cli::array <T> ^ array);
public void CopyTo(T[] array);
member this.CopyTo : 'T[] -> unit
Public Sub CopyTo (array As T())

Parametry

array
T[]

Jednowymiarowy Array obiekt docelowy elementów skopiowanych z List<T>elementu . Element Array musi mieć indeksowanie oparte na zerach.

Wyjątki

Parametr array ma wartość null.

Liczba elementów w źródle List<T> jest większa niż liczba elementów, które może zawierać miejsce docelowe array .

Uwagi

Ta metoda służy Array.Copy do kopiowania elementów.

Elementy są kopiowane do Array elementu w tej samej kolejności, w której moduł wyliczający iteruje za pośrednictwem elementu List<T>.

Ta metoda jest operacją O(n), gdzie n to Count.

Dotyczy